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ABSTRACT 


This application report contains complete code examples for routines that have been 
developed using a TMS320C54x™ EVM platform. These programs demonstrate applications 
that use a host interface and run in real time. 
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1 Running the Applications 


The host communicates to the 54x EVM through 16-bit I/O locations. Each I/O location is 
defined by an offset to an I/O page 0 address. The offset used for these applications is 0x240 + 
0x800 for channel A, 0x240 + 0x804 for channel B, and 0x240 + 0x808 for the target/status 
control register, where 0x240 is the base address of the host. Check your PC system 
documentation to make sure that I/O space 0x240 does not conflict with other I/O devices. If the 
EVM is mapped to other than space 0x240, the base addresses of the control and status 
registers must be modified in the file host.h. 


The ’54x assembler assembles code and generates object files. The linker command file links 
the object files and generates a file named main.out, using common object file format (COFF). 
You must load main.out into the EVM debugger command window with the LOAD command and 
compile the host software using a Borland C compiler. This generates the file, master.exe. that 
contains graphic routines that display data transferred from the target to the host. 


To run the target application, load main.out into the EVM debugger. To start the program on the 
target side, press the F5 function key. If you halt the program with the escape key or use the halt 
command in the debugger window, the program remains in the handshake loop waiting for the 
host to send a command. Press the F5 function key to continue. To run the host application, 
execute master.exe at the DOS prompt or a window command line. When master.exe is 
executed by the host, it displays the message: 


Graphics: No error. Press any key to halt. 


When you press this key, the graphics window opens and displays data for the task the target 
has initiated. The default task is an oscilloscope routine. To change to a different task, go to the 
debugger window, halt the program, and in the command window, type: 


e *present_command = x 
where x = 1, 2, 3, 4, 5 or 6, and present_command has one of the following values: 


= oscilloscope 

= Low-pass finite impulse response (FIR) filter using MAC instruction 

= Low-pass infinite impulse response (IIR) filter using biquad sections 

Lowpass FIR filtering using FIRS instruction 

= System identification using adaptive filtering with least mean squares (LMS) instruction 
= 256-point real fast Fourier transform (FFT) 


OahWwWND — 
Il 


You can view the output of the present task in the graphics window. 
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To exit the host application, press F3. Communication is lost if at any time the target code is 
reloaded or reset in the command window while the host executable is running in the 
background. This means that if you attempt to reset or reload the code in the debugger window 
and you press F5, the computer locks up. This occurs because there is no handshake between 
the host and the target. To unlock, reload and run the code (press F5) on the target side. On the 
host side, quit the window and rerun the executable. 


The adaptive filter can be tested in two steps. The initial step size d_mu = 0 in the first step. If 
the present task is changed at the debugger window with the command e *present_command = 
5, runs with d_mu = 0. Thus, the system is not identified since the coefficients of the adaptive 
filter are not updated. In the second step the step size can be changed by typing e *d_mu = 
0x1000 at the command window. In this case, the system is identified and the filter coefficients 
are adapted using the LMS algorithm. In both cases, the error signal can be observed both on 
host and also from the output of the “ACO1. 


2 Application Code 


Table 1 lists programs appropriate for running on a target system and tells you where to look for 
them in this chapter. 


Table 1. Target Files 


Title File Name Page 
Vector Table Initialization vectors.asm 4 
Main Program That Calls Different Functions main.asm 13 
Memory Allocation for Entire Application memory.asm r 
Processor Initialization init_54x.asm 18 
Initialization of Variables, Pointers, and Buffers prcs_int.asm 23 
Initialization of Serial Port 1 init_ser.asm 27 
*AC01 Initialization init_aic.asm 31 
‘ACO1 Register Configuration aic_cfg.asm 35 
Receive Interrupt Service Routine rcv_intl.asm 38 
Task Scheduling task.asm 42 
Echo the Input Signal echo.asm 47 
Low-Pass FIR Filtering Using MAC Instruction firasm 49 
Low-Pass Biquad IIR Filter iirasm 58 
Low-Pass Symmetric FIR Filtering Using FIRS Instruction sym_firasm 54 
Adaptive Filtering Using LMS Instruction adapt.asm 63 
256-Point Real FFT Initialization rfft.asm 71 
Bit Reversal Routine bit_rev.asm 74 
256-Point Real FFT Routine fft-asm 77 
Unpack 256-Point Real FFT Output unpack.asm 82 
Compute the Power Spectrum of the Complex Output power.asm 87 


of the 256-Point Real FFT 
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Table 2 lists programs appropriate for running on a host system and tells you where to look for 


them in this c 


hapter. 
Table 2. Communication Interface Files 

Handshake Between Host and Target hand_shk.asm 20 
Interrupt 1 Service Routine hst_intl.asm 93 
Data Transfer from FIFO fifo.asm 89 
Main Function Call on Host Side master.c 98 
Function Calls on Host Side host.c 97 
Display the Data on the Screen view2.c 102 
Graphic Drivers Routine graphic2.c 100 


Example 28 on page 102 shows the linker command that links all object files together to produce 
a single executable COFF object module. This file establishes the memory configuration for the 


entire applica 
configuration 


TEXAS INSTRUM 


tion, using the '541’s memory map. Example 29 on page 104 shows the 
of the memory map for a 541 device used by an EVM debugger. 


Example 1. Vector Table Initialization 


ENTS INCORPORATED 


DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: vectors.asm 
Version: 1.0 
Status: draft () 
proposal (X) 
accepted (.) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


VERSION 
1.0 


Application Specific Products 

Data Communication System Development 

12203 SW Freeway, MS 701 

Stafford, TX 77477; { 

IPR statements description (can be collected). 


Copyright 1996. Texas Instruments. 
All rights reserved. 
Change history: 


DATE / AUTHORS COMMENT 
July-24-96 / P.Mallela original created 
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Example 1. Vector Table Initialization (Continued) 


1. ABSTRACT 
1.1 Function Type 
a. Core Routine 
b. Subroutine 
1.2 Functional Description 
This file contains vector table of 541 


1.3 Specification/Design Reference (optional) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 
Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s vectors.asm 


1.6 Notes and Special Considerations 


This code is written for 541 device. The code is tested on 
C54x EVM 


ae 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


3.1 Include Files 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


-mmregs 
- include "inte 54x ne” 
-include "main.inc” 

: 3.2 External Data 
.ref SYSTEM _ STACK 

; 3.3 Import Functions 
.ref main_start 
.ref receive_intl 
.ref host_command_int1 


(phy pe: 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


-2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 1. Vector Table Initialization (Continued) 
Hy 4.5 Export Functions 
i} 
; 5. SUBROUTINE CODE 
; HeaderBegin 
, 
- 5.1 reset 
, 
5.2 Functional Description 
7 This function initializes the vector table of 541 device 
, 
, 
. 5.3 Activation 
r Activation example: 
, 
; Reentrancy: No 
; Recursive: No 
, 
; 5.4 Inputs 
, 
7 5.5 Outputs 
’ 
F 5.6 Global 
, 
‘ 5.7 Special considerations for data structure 
; _ 
; 5.8 Entry and Exit conditions 
, 
; DP |OVM|]SXM/|C16|]FRCT|ASM]|ARO]|AR1/]AR2|AR3|]AR4|]AR5|/AR6|/AR7/A |B |BK|BRC| T|TRN 
, 
jin 0 0 al 0 0 QO |NU |NU |NU |NU |NU |NU |NU |NU |NU]NU|NU]NU_ |NU|NU 
, 
jout |0 0 al 0 0 QO |NU |NU |NU |NU |NU |NU |NU |NU |NU|]NU|NU/]NU_ |NU|NU 
, 
; Note UM -— Used & Modified, U - Used, NU - Not Used 
, 
- 5.9 Execution 
F Execution time: ?cycles 
: Call rate: not applicable for this application 
, 
, 
; HeaderEnd 
Fy 5.10 Code 
-sect “vectors” 
reset: BD main_start ;RESET vector 
STM #SYSTEM_STACK, SP 
nmi: RETE 
NOP 
NOP 
NOP ; NMI 
; software interrupts 
sint17 -space 4*16 
sint18 -space 4*16 
sintl19 -space 4*16 
sint20 -space 4*16 
sint21 -space 4*16 
sint22 -space 4*16 
sint23 -space 4*16 
sint24 -space 4*16 
sint25 -space 4*16 
sint26 -space 4*16 
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Example 1. Vector Table Initialization (Continued) 


sint27 -space 4*16 
sint28 -space 4*16 
sint29 -space 4*16 
sint30 -space 4*16 
int0O: RETE 


NOP ; INTO 
intl: BD host_command_intl ; Host interrupt 
PSHM STO 


PSHM Stil ; INT1 
Int2s RETE 


tint: RETE 


NOP ; TIMER 


rinto: RETE ; Serial Port Receive 
NOP ; Interrupt 0 


xinto0: RETE ; Serial Port Transmit 
NOP ; Interrupt 0 


rintl: BD receive_intl ; Serial Port Receive 
PSHM STO ;Interrupt 1 

PSHM STi 

xintl: RETE ; Serial Port Transmit 
NOP ; Interrupt 1 


int3: RETE 


NOP ; INT3 


Example 2. Memory Allocation for Entire Application 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 


Filename: memory.asm 
Version: 1.0 
Status : draft () 
proposa (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 

Data Communication System Development 
12203 SW Freeway, MS 701 

Stafford, TX 77477 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 2. Memory Allocation for Entire Application (Continued) 


; IPR statements description (can be collected). 
i} 
7(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE vi AUTHORS COMMENT 
1.0 July-24-96 / P.Mallela original created 


1. ABSTRACT 
1.1 Function Type 
a.Core Routine 
b. Subroutine 
1.2 Functional Description 
This file contains main function 


1.3 Specification/Design Reference (optional) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s memory.asm 


1.6 Notes and Special Considerations 


This code is written for 541 device. The code is tested on C54x EVM 


hm ape 


2. VOCABULARY 

2.1 Definition of Special Words, Keywords (optional) 
2d hoeal Compiler Flags 

2.3 eget Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne NS 


3.1 Include Files 
-mmregs 
-include "defines.inc” 
-include "main.inc” 
3.2 External Data 


-3 Import Functions 


Ne Ne Ne Ne Ne 


(hm Sa 
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Example 2. Memory Allocation for Entire Application (Continued) 
4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 


5. SUBROUTINE COD 
HeaderBegin 


GI 


5.1 main_start 


5.2 Functional Description 
Memory configuration of the application 


5.3 Activation 
Activation example: 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Reentrancy: No 
Recursive : No 
Inputs 
5 Outputs 
5.6 Global 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 

DP | OVM|SXM|C16]|]FRCT|]ASM|]ARO]|AR1/AR2/AR3|}AR4|AR5/AR6/AR7/A |B |BK|BRC| T|]TRN 
in U 1 |NU |NU |NU NU |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU_ |NU|NU 
out |U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU_ |NU|NU 
Note : UM —- Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


© Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Call rate: not applicable for this application 
r 
; HeaderEnd 
. 5.10 Code 
STACK -usect "stack”,K_STACK_SIZE 
SYSTEM _ STACK -set K_STACK_SIZE+STACK 
input_data -usect “inpt_buf”,K_FRAME_SIZE*2 ; input data array 
output_data -usect “outdata”,K_FRAME SIZE*2 ; output data array 


; this section of variables are used in receive_intl routine and related routines 
RCV_INT1_DP -usect "rcv_vars”,0 
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Example 2. Memory Allocation for Entire Application (Continued) 


d_rcv_in_ptr -usect "rove vars”; 1 ; save/restore input bffr ptr 
d_xmt_out_ptr .usect "vrcv_vars”,1 ; save/restore output bffr ptr 
d_frame_flag -usect "rcv_vars”,1 

d_index_count .usect "“rcov_vars”,1 

; System Coefficients 

scoff -sect "coeffh” 


-include “impulse.h” 
; RAM location for the System coefficient 


hcoff -usect "pufferh”, H_FILT_SIZE 

wooff -usect "bufferw”, ADPT_FILT_SIZE ; 

; RAM location for the input data 

xh -usect "bufferx”, H_FILT_SIZE ; input data for system 

XW -usect "bufferp”, ADPT_FILT_SIZE ; input data for adaptive filter 


; RAM location for filter outputs, residual error 
; and temporary location for the new input sample. 
ADAPT_DP -usect “adpt_var”,0 
d_primary -usect “adpt_var”,1 
d_output -usect “adpt_var”,1 
d_error -usect “adpt_var”,1 
d_mu -usect “adpt_var”,1 
d_mu_e -usect “adpt_var”,1 
d_new_x -usect “adpt_var”,1 
d_adapt_count .usect “adpt_var”,1 
; the 16 tap FIR coefficients 
COFF_FIR_START .sect "“Coft fir’ ; filter coefficients 
-word 6Fh 
-word OF3h 
-word 269h 
-word 50Dh 
-word 8A9h 
-word 0C99h 
-word OFF8h 
-word 11EBh 
-word 11EBh 
-word OFF8h 
-word 0C99h 
-word 8A9h 
-word 50Dh 
-word 269h 
-word OF3h 
-word 6Fh 
COFF_FIR_END 
; Circular buffers for coefficients and data buffers 


fir_coff_table .usect "fir coft”, 20 
d_data_buffer -usect "fir br’, 40 
; variables used in FIR routine 

FIR_DP -usect "fir_vars”,0 
d_filin -usect "far vars” 71 
d_filout -usect "fir _vars”,1 

; variables used in IIR routine 

IIR_DP -usect "iir_vars”,0 
C424 og - usect "iir vars”, 3*2 
d_iir_y -usect "Tir wars”, 1 

-sect Wqsare CORE” 


iir_table_start 
* 


* second-order section # 01 
* 


-word —26778 ;A2 
-word 29529 ;Al1/2 
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Example 2. Memory Allocation for Entire Application (Continued) 


-word 19381 ;B2 
-word —23184 ;Bl 
-word —-19381 BO 


~ 


* 


* second-order section # 02 
* 


-word -—30497 ;A2 
-word 31131 7A1/2 
-word 11363 ;B2 
-word —20735 ;Bl1 
-word 11363 ;BO 
iir_table_end 
iir_coff_table -.usect "COLT 241" ,.16 
; symmetric FIR filter coeffs 
FIR_COFF -sect "“sym_fir” ; filter coefficients 
-word 6Fh 
-word OF3h 
-word 269h 
-word 50Dh 
-word 8A9h 
-word O0C99h 
-word OFF8h 
-word 11EBh 
; circular buffers used in symmetric filter routine 
d_datax_buffer .susect. “cir bfr’,20 
d_datay_buffer -usect "cir _bfr1”,20 
-include "“ref_tsk.inc” 
task_list -sect "task_tbl” ; calls the tasks itself 
-word do_nothing 
-word echo_task ; Echo routine 
-word fir_task ; FIR routine 
-word iir_task 
-word sym_fir_task 
-word adapt_task 
-word rfft_task 
task_init_list .sect "task_int” ; has the initialization of tasks 
-word do_nothing 
-word no_echo_init_task ; there is no init in this case 
-word fir_init 
-word iir_init 
-word sym_fir_init 
-word adapt_init 
-word do_nothing 
; variables used in task handling routine 


TASK_VAR_DP -usect "“tsk_vars”,0 
present_command .usect "tsk_vars”,1 
last_command -usect "tsk_vars”,1 
d_task_addr -usect “"tsk_vars”,1 
d_task_init_addr .usect "tsk_vars”,1 
d_buffer_count -usect "tsk_vars”,1 
d_output_addr -usect "tsk_vars”,1 
d_input_addr -usect "“tsk_vars”,1 
; Set start addresses of buffers 
fft_data -usect "fft_bffr”, 4*K_FFT_SIZE ; fft data processing buffer 
; Copy twiddle tables 
-sect "sin_tbl” 
sine_table . copy twiddlel ; sine table 
sine -usect “twid_sin”,K_FFT_SIZE 
-sect "cos_tbl” 
cos_table .copy twiddle2 ; cosine table 
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Example 2. Memory Allocation for Entire Application (Continued) 

cosine -usect "“twid_cos”,K_FFT_SIZE 

; Define variables for indexing input data and twiddle tables 

FFT_DP -usect “fft_vars”,0 

d_grps_cnt -usect "fft_vars”,1 ; (# groups in current stage) -1 

d_twid_idx -usect "fft_vars”,1 


; index of twiddle tables 
-usect "fft_vars”,1 ; index of input data table 
;variables used for host interface 


d_data_idx 


FIFO_DP -usect “fifo_var”,0 

d_command_reg -usect "“fifo_var”’,1 

d_command_value .usect "fifo_var”,1 

d_fifo_count -usect "fifo_var”,1 

d_fifo_ptr -usect "“fifo_var”,1 
.end 


defines.inc 


; Filenam 


; this include file defines all the variables, buffers and pointers used for the 


; application 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
-def. 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
.def 
; Filename: 
; this includ 
.ref 
.ref 
.ref 
.ref 
.def 


STACK, SYSTEM_STACK 

input_data, output_data 
scoff,hcoff,wcoff, xh, xw 
ADAPT_DP,d_primary, d_output,d_error 
d_mu, d_mue, d_new_x, d_adapt_count 
fir_coff_table, d_data_buffer 
FIR_DP,d_filin,d_filout 
COFF_FIR_START, COFF_FIR_END 
IIR_DP,d_iir_d,iir_y 

iir_coff_table 
COFF_FIR_START, COFF_FIR_END 
d_datax_buffer,d_datay_buffer 
FIR_COFF 
TASK_VAR_DP, present_command, last_command 
d_task_addr,d_task_init_addr, d_buffer_count, d_output_addr 
RCV_INTL_DP 

d_rcv_in_ptr,d_xmt_out_ptr 

d_frame_flag, d_index_count 

fft_data,sine, cosine 

FFT_DP,d_grps_cnt, d_twid_idx, d_data_idx 
cos_table,sine_table 

FIFO_DP 

d_command_reg 

d_fifo_count 

d_fifo_ptr 

ref_tsk.inc 

es all the task scheduling table referenced labels 
do_nothing,echo_task, fir_task,iir_task 

sym_fir_task, fir_init,iir_init,sym_fir_init 
no_echo_init_task, fir_init,iir_init,sym_fir_init 
adapt_init 

task_init_list,task_list 
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Example 3. Main Program That Calls Different Functions 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: main.asm 
Version: 1.0 
Status : draft C) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-24-96 / P.Mallela original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b. Subroutine 


1.2 Functional Description 
This file contains main function 


Specification/Design Reference (optional) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s main.asm 


1.6 Notes and Special Considerations 


This code is written for 541 device. The code is tested on C54x EVM 


ph Nap 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne SN 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne 
we 


Orr 


ba TEXAS 
INSTRUMENTS 


Example 3. Main Program That Calls Different Functions (Continued) 


-2 Local Compiler Flags 


-3 Local Constants 


EXTERNAL RESOURCES 


-l Include Files 


-mmregs 
.- include "init. S4ax.ane” 
- include "main.inc” 

-2 External Data 
.ref d_frame_flag 
.ref RCV_INT1_DP 

-3 Import Functions 
.ref aic_init,serial_init,init_54,init_bffr_ptr_var 
.ref task_handler, evm_handshake, fifo_host_transfer 


INTERNAL RESOURCES 


-1 Local Static Data 


-2 Global Static Data 


-3 Dynamic Data 


-4 Temporary Data 


-5 Export Functions 


.def main_start 


SUBROUTINE CODE 


HeaderBegin 


-l main_start 


-2 Functional Description 


This is the main function that calls other functions. 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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-3 Activation 


Activation example: 
BD main_start 
PSHM STO 
PSHM ST1l 


Reentrancy: No 
Recursive : No 


-4 Inputs 
-5 Outputs 


-6 Global 
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Example 3. Main Program That Calls Different Functions (Continued) 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 
DP | OVM|SXM|C16]|]FRCT|]ASM]ARO]|AR1/AR2/AR3|}AR4|AR5/AR6/AR7/A |B |BK|BRC| T]TRN 


yin |U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU |NU|NU 


Note : UM —- Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


, 
, 
, 
, 
r 
, 
, 
, 
;out|U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU_ |NU |NU_ |NU/NU|NU|NU |NU/NU 
, 
, 
, 
r 
, 
‘ Call rate: not applicable for this application 

, 

il 


; HeaderEnd 
5.10 Code 

-sect “main_prg” 
KKEKEKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKEEKE 
* The code initializes the 541 device, handshake between Target (DSP) 
* and the host (PC). Zeros all buffers, variables and init. pointers 
* Initializes serial port, programs ACO1 registers for selecting sampling 
* rate, gains etc.. 

KKEKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKEESEK 

main_start: 

CALL init_54 ; initialize STO,ST1 PMST and 

; other registers 


sae K_HOST_FLAG = 1 

CALL evm_handshake ; EVM host handshake 

-endif 

CALL init_bffr_ptr_var ; init tables,vars,bffrs,ptr 
CALL serial_init ; initialize serial_port 1 
CALLD aic_init ; Configures ACO1 

LD #0,DP 

NOP 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKKKKKKKKKKKKKKKKKKK 


* After enabling interrupts from the above, the real processing starts here. 
* After collecting 256 samples from ACO1 a flag(d_frame_flag is set). 

* Handles the task initiated by the user and transfers the data to the 

* host. Keeps the sequence forever !!!!! 
KEKKKKKKKKKKKKKKKKKKKKK KKK KKK KKKKKKKKKKKKKKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


start_loop 


LD #RCV_INT1_DP, DP 7 restore the DP loop: 
BITF d_frame_flag,1 ; if 256 samples are received 
BC loop, NTC ; if not just loop back 
CALL task_handler ; handles task scheduling 
CALL fifo_host_transfer ; EVM HOST interface 
B loop 
.end 
* Includes all the constants — main.inc 
K_O -set 0 ; constant 
K_FIR_INDEX -set 1 ; index count 
K_FIR_BFFR -set 16 ; FIR buffer size 
K_negl -set -lih ; index count 
K_BIQUAD -set 2 ; there are 2 bi-quad sections 
K_IIR_SIZE -set 10 ; each bi-quad has 5 coeffs 
K_STACK_SIZE -set 200 ; stack size 
K_FRAME_SIZE .set 256 ; PING/PONG buffer size 
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Example 3. Main Program That Calls Different Functions (Continued) 


K_FRAME_FLAG -set 1 ; set after 256 collected 
H_FILT_SIZE -set 128 ; H(z) filter size 
ADPT_FILT_SIZE -set 128 ; W(z) filter size 

K_mu -set Oh ; initial step constant 
K_HOST_FLAG -set 1 ; Enable EVM_HOST interface 
K_DEFAULT_ACO1 -set lh ; Gefault ACO1 init 


* This include file sets the FFT size for the C54x Real FFT code 
* Note that the Real FFT size (i.e. the number of points in the 

* original real input sequence) is 2N; whereas the FFT size is 

* the number of complex points formed by packing the real inputs, 
* which is N. For example, for a 256-pt Real FFT, K_FFT_SIZE 
* 
K 


should be set to 128 and K_LOGN should be set to 7. 


_FFT_SIZE .set 128 ; # of complex points (=N) 
K_LOGN set 7 ; # of stages (=logN/1log2) 
K_ZERO_BK -set 0 
K_TWID_TBL_SIZE -set 128 ; Twiddle table size 
K_DATA_IDX_1 -set 2 ; Data index for Stage 1 
K_DATA_IDX_2 -set 4 ; Data index for Stage 2 
K_DATA_IDX_3 -set 8 ; Data index for Stage 3 
K_FLY_COUNT_3 .set 4 ; Butterfly counter for Stage 3 
K_TWID_IDX_3 .set 32 ; Twiddle index for Stage 3 
ee NE kee EU ee ER EE Ny a ee eee 
* FILENAME: INIT54x.INC 


* This include file contains all the initial values of STO, ST1, PMST, SWWSR, BSCR 
registers 
* STO Register Organization 


15 13 12 11 10 9 8 0 


ARP TC Cc OVA| OVB DP 


+ + + + + 


* 
KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


K_ARP -set 000b<<13 ; ARP can be addressed from 00b -111b 
; reset value 

K_TC -set 1lb<<12 ; TC = 1 at reset 

K€ -set 1lb<<1l1 ; C = 1 at reset 

K_OVA -set 1b<<10 ; OVA = 0 at reset, Set OVA 

K_OVB -set lb<< 9 i OVB = 0 at reset, Set OVB 

K_DP .set 000000000b<<0 DP is cleared to 0 at reset 

K_STO .set K_ARP|K_TC|K_C|K_OVA K_OvB|K DP 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


*ST1 Register Organization 
* 


15 | a4. | we | ae | a | tol] el] el ei] ef] aia 0 


BRAF| CPL| xXF | HM |INTM| 0 |ovm|sxm|c16|FRCT|cMPT| aAsM 


+ + + + HF 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


K_BRAF -set Ob << 15 ; BRAF = 0 at reset 
K_CPL -set Ob << 14 ; CPL = 0 at reset 
K_XF -set 1b: << 13 ; XF = 1 at reset 
K_HM -set Ob << 12 ; HM = 0 at reset 
K_INTM -set lb << 11 ; INTM 

K_ST1_RESR -set Ob << 10 ; reserved 

K_OVM -set lb << 9 ; OVM = 0 at reset 
K_SXM -set lb << 8 ; SXM = 1 at reset 
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Example 3. Main Program That Calls Different Functions (Continued) 


K_C16 -set Ob << 07 ; C16 = 0 at reset 

K_FRCT -set lb << 06 ; FRCT = 0 at reset, Set FRCT 
K_CMPT -set Ob << 05 i CMPT = 0 at reset 

K_ASM -set 00000b << 00 ASM = 0 at reset 

K_ST1_HIGH _. set K_BRAF | K_CPL|K_XF|K u|k INTM|K_ST1_RESR|K_OVM|K_SxXM 
K_ST1_LOW .set K_C16|K_FRCT|K_CMPT|K_ASM 

K_ST1 .set K_ST1_HIGH|K_ST1_LOW 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


*PMST Register Organization 
* 


* 15 7 6 5 4 3 2 1 o | 
* 
* IPTR |MP/MC |OVLY|AVIS|DROM|CLKOFF| Reserved | 
* 
K_IPTR -set 1111AItib << 07 ; 111111111b at reset 
K_MP_MC -set lb << 06 ; 1 at reset 
K_OVLY -set Ob << 05 ; OVLY = 0 at reset 
K_AVIS -set Ob << 04 ; AVIS = 0 at reset 
K_DROM -set Ob << 03 ; DROM = O at reset 
K_CLKOFF -set Ob << 02 ; CLKOFF = 0 at reset 
K-PMST_RESR -set OOb << 0 ; reserved 

; for 548 bit 0 = SMUL 

i saturation on multiply 

bit 1 = SST = saturation on store 

K_PMST .set K_IPTR|K_MP_MC|K_OVLY|K_ Avts|K_ DROM|K_CLKOFF |K_PMST_RESR 


KEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKKK KKK KKKKKKKKKKKK KKK KKK KKK KKKKKKKKKKKKKKKKKK 
*SWWSR Register Organization 


| 15 |14 1211 9|8 6) 5 3 |2 o | 


+ + + 


| Reserved | 1/0 | Data | Data |Program|Program | 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KK KKK KKK KKKKKKKKKKKKKKKKKKKK 


K_SWWSR_IO .set 2000h ; set the I/O space 


KKEKKKKKKKKKKKKKKKKKKKKKKKKKK KK KKK KKK KKKKK KKK KKK KKK KK KK KK KK KKK KKK KKKKKKKKKKKKKKKKKK 
*Bank Switching Control Register (BSCR) Organization 


* 

* [| 15 12 | 11 | 10 2/ 1]| «0 

* 

* |  BNKCMP | PS-DS | Reserved | BH | EXIO | 

* 

KEKE KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKKKEK 
K_BNKCMP -set O0000b << 12 ; bank size = 64K 
K_PS_DS -set Ob << 11 

K_BSCR_RESR_.set OO00000000b <<2 ; reserved space 
K_BH -set Ob << 1 ; BH = 0 at reset 
K_EXIO -set Ob << 0 ; EXIO = 0 at reset 
K_BSCR .set K_BNKCMP | K_PS_DS|K_BSCR_RESR|K_BH|K_EXIO 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


{ 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne SN 
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Example 4. Processor Initialization 


INSTRUMENTS INCORPORATED 


DSP Data Communication System Development / ASP 
Archives: PVCS 
Filename: init_54x.asm 
Version: 1.0 
Status draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 
Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
IPR statements description (can be collected). 
C) Copyright 1996. Texas Instruments. All rights reserved. 
Change history: 
VERSION DATE / AUTHORS COMMENT 
1.0 July-29-96 / P.Mallela original created 
1. ABSTRACT 
1.1 Function Type 
a.Core Routine 
b. Subroutine 
1.2 Functional Description 
This file contains initialization of the processor 
1.3 Specification/Design Reference (optional) 
1.4 Module Test Document Reference 
Not done 
1.5 Compilation Information 
Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s init_54x.asm 
1.6 Notes and Special Considerations 
This code is written for 541 device. The code is tested on C54x EVM 


ap 


Zed. 


VOCABULARY 


Definition of Special Words, Keywords (optional) 
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Example 4. Processor Initialization (Continued) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne 
ry 


3.1 Include Files 

-mmregs 

- include "init. 54x.ine” 
-2 External Data 
-3 Import Functions 


WW 


ae 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


4.5 Export Functions 
.def init_54 


5. SUBROUTINE CODE 
HeaderBegin 


5.1 init_54 


5.2 Functional Description 
Initializes the processor from a reset state 


5.3 Activation 
Activation example: 


CALL init_54 
Reentrancy: No 
Recursive : No 


5.4 Inputs 
5.5 Outputs 


5.6 Global 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 4. Processor Initialization (Continued) 


DP | OVM| SXM|C16|FRCT]ASM]ARO}]AR1/AR2/AR3|/AR4]AR5/AR6|AR7|A |B |BK|BRC| T|TRN 


;in |NU/NU |NU |NU |NU NU |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU |NU|NU 


;out}]NU|NU |NU |NU |NU NU |NU |NU |NU |NU |UM |UM |NU |NU |NU|NU/NU|NU_ |NU/NU 
Note : UM - Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


; 
7 
7 
7 
7 
7 
7 
7 
7 
7 
7 
7 
7 
7 
7 


Call rate: not applicable for this application 
HeaderEnd 
5.10 Code 
.sect "main_prg” 
init_54: 
; Init.the s/w wait state reg.for 2 wait states for I/O operations 
STM #K_SWWSR_IO, SWWSR ; 2 wait states for I/O operations 
; wait states for Bank Switch 
STM #K_BSCR, BSCR ; O wait states for BANK SWITCH 
; initialize the status and control registers 
STM #K_STO, STO 
STM #K_ST1, ST1 
RETD 
STM #K_PMST, PMST 
.end 


Example 5. Handshake Between Host and Target 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: hand_shk.asm 
Version: £0) 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 

{ 

IPR statements description (can be collected). 

} 

(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-26-96 / P.Mallela original created 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


(hm Sa 
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Example 5. Handshake Between Host and Target (Continued) 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains one subroutine: 
1) evm_handshake 
1.3 Specification/Design Reference (optional) 
called by main.asm depending upon if K_HOST_FLAG is set 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s hand_shk.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


-mmregs 
- include "target.inc” 
- include "init 54x%.i1ne” 
- include “interrpt.inc” 
7 3.2 External Data 
.ref FIFO_DP 
.ref d_command_reg 
.ref d_command_value 


3.3 Import Functions 


a ge 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


4.5 Export Functions 
.def evm_handshake 
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Example 5. Handshake Between Host and Target (Continued) 


SUBROUTINE CODE 
HeaderBegin 


5.1 evm_handshake 


5.2 Functional Description 


This initiates the handshake between the host(PC) and the target (DSP). 
The host writes a command to CH A. This generates an INT1 on the target. 
The AXST bit on HCR is set to 1.The bit in IFR is polled if it is set 
then it is cleared to clear pending interrupts. The FIFO is cleared 

by reading from the FIFO. The command from host is read thru CH A and 
ARST on TCR is cleared. Another command from target is written to CH A, 
which sets AXST. Also sets XF low. The host polls XF line. The host reads 
CH A which clears ARST on host side and AXST on target side. 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Activation 
Activation example: 
CALL evm_handshake 
Reentrancy: No 
Recursive : No 
Inputs 
NONE 
Outputs 
NONE 
Global 
Data structure: d_command_reg 
Data Format: 16-bit variable 
Modified: Yes 
Description: command from host is read thru CH A 
Data structure: d_command_value 
Data Format: 16-bit variable 
Modified: Yes 
Description: holds the command value 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 


DP | OVM| SXM|C16|FRCT|]ASM]ARO]AR1/AR2/AR3|/AR4]AR5/AR6|AR7|A |B |BK|BRC| T|TRN 


ain | 


out |U 


Note 


1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU |NU|NU 
1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |UM|NU|NU|NU |NU|NU 


UM - Used & Modified, U - Used, NU - Not Used 


5.9 Execution 


Execution time: ?cycles 
Call rate: not applicable for this application 
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Example 5. Handshake Between Host and Target (Continued) 


7 


; HeaderEnd 
7 5.10 Code 
-sect "“handshke” 
evm_handshake: 
LD #0,DP 
BITF IFR, 02h ; Poll for INT1 
BC evm_handshake, NTC ; ARST = 1 
ST #K_INT1,IFR ; clear the pending interrupt 
LD #FIFO_DP,DP 
RPT #K_FIFO_SIZE-1 
PORTR K_CHB, d_command_reg assures that FIFO is empty to 
PORTR K_CHA, d_command_value ARST = 0 


read the command from HOST 
;to acknowledge INT1 


target_handshake_command: 


Ne Ne Ne Ne 


PORTR K_TRGCR_ADDR, d_command_reg ; while (portl14 & ARST) 
BiTF d_command_reg, K_ARST ; check FIFO empty 
BC target_handshake_command, TC ; branch occurs 
LD #K_HANDSHAKE_CMD,A ; indicate of FIFO empty 
SUB d_command_value,A 
bad_handshake_command 
BC bad_handshake_command, ANEQ ; read the command send by hosts 
ST #K_AXST_CLEAR, d_command_reg ; send to a command to clear AXST 
PORTW d_command_reg, K_CHA ; write command to command reg A 
; AXST = 1 
RSBX XF ; XF = 0 
RET 
.end 


Example 6. Initialization of Variables, Pointers, and Buffers 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: pres_int.asm 
Version: 1.0 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 
IPR statements description (can be collected). 


} 
(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
120 July-29-96 / P.Mallela original created 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


nae 
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Pon) 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 6. Initialization of Variables, Pointers, and Buffers (Continued) 
ABSTRACT 
-1 Function Type 


a.Core Routine 
b.Subroutine 


Functional Description 
This file contains initialization of buffers,pointers and variables 


Specification/Design Reference (optional) 


Module Test Document Reference 
Not done 


Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02. (BC) 
Activation: asm500 -s prcs_int.asm 


-6 Notes and Special Considerations 


code is written for 541 device. The code is tested on C54x EVM 


VOCABULARY 


-1 Definition of Special Words, Keywords (optional) 


-2 Local Compiler Flags 


-3 Local Constants 


EXTERNAL RESOURCES 


-l Include Files 


-mmregs 
- include "main.inc” 

-2 External Data 
.ref input_data, output_data 
<rer present_command 
-ref d_rcev_in_ptr,d_xmt_out_ptr 
.ref RCV_INT1_DP 
srer d_buffer_count 


-3 Import Functions 


INTERNAL RESOURCES 


Local Static Data 


Global Static Data 


Dynamic Data 


Temporary Data 
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Example 6. Initialization of Variables, Pointers, and Buffers (Continued) 


4.5 Export Functions 


.def init_bffr_ptr_var 


SUBROUTINE CODE 
HeaderBegin 


init_bffr_ptr 


Functional Description 
This routine initializes all the buffers, pointers and variables 


Activation 


Activation example: 


CALL init_bffr_ptr_var 


Reentrancy: 
Recursive 


Inputs 
NONE 
Outputs 
NONE 
Global 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


AR2 

16-bit input buffer pointer 

Yes 

initialize to the starting address 


AR3 

16-bit output buffer pointer 

Yes 

initialize to the starting address 


present_command 

16-bit variable 

Yes 

holds the present command 


input_data 

16-bit array 

Yes 

address of the input data buffer 


output_data 

16-bit array 

Yes 

address of the output data buffer 


d_rcv_in_ptr 

16-bit var 

Yes 

holds the staritng address of input bffr 


d_xmt_out_ptr 

16-bit variable 

Yes 

holds the starting address of output bffr 
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Example 6. Initialization of Variables, Pointers, and Buffers (Continued) 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 


, 
, 
, 
, 
, 
; DP |OVM|SXM/|C16|]FRCT|ASM]|ARO|AR1|AR2|AR3|]AR4|AR5|AR6|AR7|A |B |BK|BRC| T|TRN 
, 
jin |0 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |NU/NU|O |NU |NU/NU 
, 
;out}|2 1 1 |NU 1 NU |NU |UM |UM |UM |NU |NU |NU |NU |UM/|NU|O |NU |NU/NU 
, 
; Note UM -— Used & Modified, U - Used, NU - Not Used 
, 
, 
: 5.9 Execution 
Execution time: ?cycles 
; Call rate: not applicable for this application 
, , 
; HeaderEnd 
; 5.10 Code 
-asg AR1,ZRPAD_P ; zero pad pointer 
-asg AR2,GETFRM_IN_P ; get frame input data pointer 
-asg AR3,GETFRM_OUT_P ; get frame output data pointer 
-asg AR2,COFF_P 
-sect "zeropad” 
init_bffr_ptr_var: 
STM #RCV_INT1_DP,AR2 ; init all vars to 0 
RPTZ A, K_FRAME_SIZE/2-1 ; this may need mods if all vars 
STL A, *AR2+ ; are not in 1 page 
STM #input_data, GETFRM_IN_P ; input buffer ptr 
STM #output_data, GETFRM_OUT_P ; output buffer ptr 
LD #RCV_INT1_DP,DP 
MVKD GETFRM_IN_P,d_rcv_in_ptr ; holds present in. bffr ptr 
MVKD GETFRM_OUT_P,d_xmt_out_ptr 7 holds present out bffr ptr 
ST #3, present_command ; initialize present command 
ST #K_0, d_buffercount ; reset the buffer count 
STM #input_data, ZRPAD_P 
RPTZ A, 2*K_FRAME SIZE-1 ; zeropad both bottom 256 
input_data 
STL A, *ZRPAD_Pt ; and fft_data buffers 
STM #output_data, ZRPAD_P 
RPTZ A, 2*K_FRAME SIZE-1 
STL A, *ZRPAD_Pt+ 
RET 
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Example 7. Initialization of Serial Port 1 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: init_ser.asm 
Version: LO 
Status : draft G-) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela/Ramesh A Iyer 


Application Specific Products 

Data Communication System Development 
12203 SW Freeway, MS 701 

Stafford, TX 77477 

{ 

IPR statements description (can be collected). 


} 
(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-29-96 / P.Mallela original created 
} 
{ 
ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains the initialization of the serial port 1 


1.3 Specification/Design Reference (optional) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s init_ser.asm 


1.6 Notes and Special Considerations 


This code is written for 541 device. The code is tested on C54x EVM ; 


ea SS. 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Ne Ne Ne Ne Ne Ne Ne 
ha ae 


Ne Ne Ne Ne Ne Ne Ne Ne Ne 
—— 
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Example 7. Initialization of Serial Port 1 (Continued) 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


3.1 Include Files 


-mmregs 
- include “interrpt.inc” 
- include “init_ser.inc” 
3.2 External Data 
NONE 
3.3 Import Functions 
NONE 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


AIC_VAR_DP -usect 
aic_in_rst -usect 
aic_out_of_rst .usect 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 
.def serial_init 


5. SUBROUTINE COD 
HeaderBegin 


Gl 


"“aic_vars”,0 
"“aic_vars”,1 
"“aic_vars”,1 


5.1 serial_init 


5.2 Functional Description 


This routine initializes the serial port 1 of 541. 


The serial port is put 


in reset by writting 0’s to RRST and XRST bits and pulled out of reset by 


writting 1’s to both RRST and XRST bits. 


This routine also puts the ACO1 


in reset and after 12 cycles the ACO1 is pulled out of reset. The serial 
port initialization is done during the 12 cylce latency of the ACO1 init. 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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5.3 Activation 
Activation example: 


CALL serial_init 
Reentrancy: No 
Recursive : No 


5.4 Inputs 
5.5 Outputs 


5.6 Global 
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Example 7. Initialization of Serial Port 1 (Continued) 


Data structure: aic_in_rst 


Data Format: 16-bit variable 
Modified: Yes 
Description: holds the value to put ACO1 in reset state 


Data structure: aic_out_of_reset 


Data Format: 16-bit variable 
Modified: Yes 
Description: holds the value to put ACO1 out of reset state 


5.7 Special considerations for data structure 

38 nae and Exit conditions 

DP |OVM| SXM|C16]FRCT|ASM|/ARO|AR1]AR2/]AR3|AR4/AR5|AR6/AR7|A |B |BK|BRC| T|TRN 
yin |0 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU/NU|NU_ |NU|NU 
ov U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU_ |NU |NU|NU/NU|NU |NU|NU 
é Note : UM —- Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


r 
, 
’ 
’ 
1 
’ 
id 
’ 
v 
A 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
La 
’ 
v 
’ 
v 
la 
’ 
’ 


Call rate: not applicable for this application 
; HeaderEnd 
. 5.10 Code 
-sect "ser_cnfg” 
serial_init: 
LD #AIC_VAR_DP, DP ; initialize DP for aic_reset 
ST #K_0O, aic_in_rst ; bit 15 = 0 of TCR resets AIC 
PORTW aic_in_rst,K_TRGCR_ADDR ;write to address 14h (TCR) 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KK KKKKKKKKKKKKKKKKKKKKKK 


*We need at least 12 cycles to pull the AIC out of reset. 
KEKKKKKKKKKKKKKKKKKK KKK KKK KKK KKKK KK KK KKK KK KK KKK KKK KKKK KKK KKKKKKKKKKKKKKKKKKKKKKKK 


STM #K_SERIAL RST, SPC1 ;reset the serial port with 
70000 0000 0000 1000 

STM #K_SERIAL_OUT_RST, SPC1 ;bring ser.port out of reset 
70000 0000 1100 1000 

RSBX INTM 

LD #0,DP 

ORM # (K_RINT1|K_INT1), IMR ; Enable RINT1,INT1 
7 0000 0000 0100 0010 

LD #AIC_VAR_DP, DP ; restore DP 

STM # (K_RINT1),IFR ; clear RINTI1 

STM #K_0,DXR1 7 0000 0000 0100 0000 


; Pull the ACO1 out of reset - the ACO1 requires that it be held in reset for 
; 1 MCLK, which is equivalent to 96.45ns (based on an MCLK of 10.368MHz) 


ST #K_8000, aic_out_of_rst ; bit 15 = 1 brings AIC from reset 
RETD 

PORTW aic_out_of_rst, K_TRGCR_ADDR ; AIC out of reset 

.end 
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KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKKKKKK 


* FILENAME: “INIT_SER.INC™ 

* 

* 15 14 13 12 11 10 9 8 
* 

* FREE SOFT| RSRFULL| XSREMPTY| XRDY RRDY IN1| INO 
: 

- 7 6 5 4 3 2 1 0 

* 

* RRST XRST| TXM MCM| FSM FO DLB RES 

: 


This include file includes the SPCl register configuration 
KEKKKKKKKKKKK KKK KKK KK KKK KKK KKK KKK KK KK KKK KKK KK KKK KKK KKKKKKKKKKKKKKKKKKKKKK 


;Bit Name Function 
70 Reserved Always read as 0 
;1 DLB Digital loop back: 0 -> Disabled, 1_.Enabled 
72 FO Format bit: O -> data transfered as 8 bit bytes, 1 -> 16 bit 
words 
1S FSM Frame sync pulse: 0 -> serial port in continuous mode, 1 -> FSM 
is required 
74 MCM Clock mode bit: 0 -> CLKX obtained from CLKX pin 1 -> CLKX 
obtained from CLKX 
Hie) TXM Transmit mode bit: 0 -> Frame sync pulses generated externally 
and supplied on FSX pin, 1 -> Internally generated frame sync 
pulses out on FSX pin 
76 XRST Transmit reset bit: 0 -> reset the serial port, 1 -> bring 
serial port out of reset 
He RRST Receive reset bit: 0 -> reset the serial port, 1 -> bring 
serial port out of reset 
78 INO Read-only bit reflecting the state of the CLKR pin 
79 IN1 Read-only bit reflecting the state of the CLKX pin 
710 RRDY Transition from 0 to 1 indicates data is ready to be read 
pil XRDY Transition from 0 to 1 indicates data is ready to be sent 
2 XSREMPTY Transmit shift register empty ( Read-only) 0 -> tramsitter 
has experienced underflow 
13 RSRFUL Receive shift register full flag (Read-only): 0 -> Receiver 
has experienced overrun 
714 SOFT Soft bit - 0 -> immdeiate stop, 1-> stop after word completion 
715 FREE Free run bit: 0 -> behaviour depends on SOFT bit, 1-> free run 
regardless of SOFT bit 
The system has the following configuration: 
Uses 16-bit data => FO = 0 
Operates in burst mode => FSM = 1 
CLKX is derived from CLKX pin => MCM = 0 
Frame sync pulses are generated externally by the AIC => TXM = 0 
Therefore, to reset the serial port, the SPC field would have 


0000 0000 0000 1000 
To pull the serial port out of reset, 
0000 0000 1100 1000 


the SPC field would have 


Px Ns Ne Ne Ne Ne Ne Ne Ne Ne 


_0 -set OO0000000b << 8 ; bits 15-8 to 0 at reset 

_RRST -set Ob << 7 ; First write to SPCl is 0 
; second write is 1 

K_XRST -set Ob << 6 ; First write to SPCl is 0 
; second write is 1 

K_TXM -set Ob << 5 

K_MCM .set Ob << 4 

K_FSM -set lb. <<.-3 ; Frame Sync mode 

K_ZERO -set O000b << 0 
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Example 7. Initialization of Serial Port 1 (Continued) 


K_SERIAL_RST .set K_0|K_RRST|K_XRST|K_TXM|K_MCM|K_FSM|K_ZERO 
; first write to SPCl register 
K_RRST1 -set lb << 7 ; second write to SPC1 
K_XRST1 -set lb << 6 ; second write to SPC1 
K_SERIAL_OUT_RST «set K_0|K_RRST1|K_XRST1|K_TXM|K_MCM|K_FSM|K_ZERO 
K_TRGCR_ADDR -set 14h ; Target/Status I/O address 
K_0O .set Oh 
K_8000 -set 8000h ; set bit 15 to pull AIC out 
; of reset 
* FILENAME: INTERRUPT.INC 
* 
* 15 9 7 6 5 4 a 2 i 0 
* 
* Reserved | INT3| XINT1| RINT1| XINTO| RINTO| TINT] INT2|] INT1] INTO 
* 
* 


This file includes the IMR and IFR configuration 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


K_IMR_RESR 
K_INT3 
K_XINT1 
K_RINT1 
K_XINTO 
K_RINTO 
K_TINT 
K_INT2 
K_INT1 
K_INTO 


{ 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
7 ( 
{ 


LO 


Ne Ne Ne Ne Ne Ne Ne Ne SN 


nae 


.set QO000000b << 9 


Change history: 


VERSION 


reserved space 


Td 
-set lb << 8 ; disable INT3 
-set Ih <7 ; disable transmit interrupt 1 
-set lb << 6 ; enable receive interrupt 1 
-set lb << 5 ; disable transmit interrupt 0 
.set lb << 4 ; disable receive interrupt 
-set lb << 3 ; disbale timer interrupt 
.set lb << 2 ; disable INT2 
-set lb << 1 ; disbale INT1 
.set lb << 1 ; enable INTO 


Example 8. ’AC01 Initialization 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: init_aic.asm 
Version: 1.0 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela/Ramesh A. Iyer 


Application Specific Products 

Data Communication System Development 
12203 SW Freeway, MS 701 

Stafford, TX 77477 


IPR statements description (can be collected). 


C) Copyright 1996. Texas Instruments. All rights reserved. 


DATE / AUTHORS COMMENT 
July-29-96/ P.Mallela original created 
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ae a 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
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Example 8. *AC01 Initialization (Continued) 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains the initialization of ACO1 


1.3 Specification/Design Reference (optional) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s init_aic.asm 


1.6 Notes and Special Considerations 


This code is written for 541 device. The code is tested on C54x EVM ; 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


3.1 Include Files 

-mmregs 

- include “interrpt.inc” 
3.2 External Data 
NONE 
3.3 Import Functions 

.ref wrt_cnfg ; initializes ACO1 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 
.def aic_init 
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Example 8. *AC01 Initialization (Continued) 


5. SUBROUTINE CODE 
HeaderBegin 


5.1 aic_init 


5.2 Functional Description 
This routine disables IMR and clears any pending interrupts before 
initializing ACO1. The wrt_cnfg function configures the ACO1 


5.3 Activation 
Activation example: 


CALL aic_init 
Reentrancy: No 
Recursive : No 


5.4 Inputs 


5.6 Global 


5.7 Special considerations for data structure 
5.8 Entry and Exit conditions 
DP |OVM| SXM|C16]FRCT|ASM|]ARO|AR1]AR2|]AR3|AR4/AR5|AR6/AR7|A |B |BK|BRC| T|TRN 
yin 0 1 1 |NU 1 ;NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU |NU|NU 
,out 0 il 1 |NU 1 |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU_ |NU|NU 
Note : UM - Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


, 
, 
, 
a 
rd 
, 
r 
, 
ta 
, 
, 
, 
, 
, 
r 
a 
| 
, 
, 
r 
, 
, 
7 5.5 Outputs 
a 
r 
, 
, 
r 
, 
, 
, 
a 
, 
, 
la 
F 
f 
a 
, 
, 
, 
, 
a 
, 
a 
, 


Call rate: not applicable for this application 
HeaderEnd 

5.10 Code 
-sect "aic_cnfg” 

aie. Anite 

CALLD wrt_cnfg ; initialize ACO1 
ANDM #(~K_RINT1|K_INT1),IMR ; disable receive_int1,INT1 
ORM # (K_RINT1|K_INT1),IMR ; enable the RINT1, INT1 
RETD 
STM (K_RINT1),IFR ; service any pending interrupt 
.end 
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Example 8. *AC01 Initialization (Continued) 


KKK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKEK KKK KK 


+ + F F F HF 


[This file includes the ACO1 registers initialization 

All registers have 2 control bits that initiates serial communication 

There are 2 communication modes - primary and secondary communications 
During primary communication the control bits DOO and DO1 are 11 to request 
for a secondary communication. In the secondary serial communications the 
control bits D15 and D14 perform same control function as primary. 

The R/W~ bit at reset is set to 0 placing the device in write mode. 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKEKKKEKKKKKEKK KK KK 


K_NOP_ADDR set 0 << 8 

K_REG_0 set K_NOP_ADDR 

K_A_ADDR -set 1 << 8 ; REG 1 address 

K_A_REG set 36 ; 

K_REG_1 -set K_A_ADDR|K_A_REG ; FCLK = 144KHz => A =24h 

K_B_ADDR -set 2 << 8 ; REG 2 address 

K_B_REG set 18 ; 

K_REG_2 -set K_B_ADDR|K_B_REG ; Sampling rate = 8KHz 

K_AA ADDR -set 3 << 8 ; Register 3 address 

K_AA_REG set 0 i 

K_REG_3 .set | _K_AA_ADDR|K_AA REG; ; no shift 

K_GAIN_ADDR -set 4 << 8 ; Register 4 address 

K_MONITOR_GAIN set O00b << 4 ; Monitor output gain = squelch 

K_ANLG_IN_GAIN set Olb << 2 ; Analog input gain = OdB 

K_ANLG_OUT_GAIN set Olb << 0 ; Analog output gain = O0dB 

K_REG_4 “set K_GAIN ADDR |K MONITOR GAIN|K ANLG_IN. GAIN|K ANLG_OUT_GAIN 

K_ANLG_CNF_ADDR .set 5 << 8 ; Register 5 address 

K_ANLG_RESRV .set Q << 3 ; Must be set to OK_HGH_FILTER .set 0 << 2 
; High pass filter is enabled 

K_ENBL_IN .set Olb << 0 ; Enables IN+ and IN- 

K_REG_5 eset K_ANLG_CNF_ADDR | K_ANLG RESRV |K HGH FILTER |K_ENBL_IN 

K_DGTL_CNF_ADDR .set 6 << 8 ; Register 6 address 

K_ADC_DAC .set Q << 5 ; ADC and DAC is inactive 

K_FSD_OUT .set 0 << 4 ; Enabled FSD output 

K_16_BIT_COMM .set Q << 3 ; Normal 16-bit mode 

K_SECND_COMM .set Q << 2 ; Normal secondary communication 

K_SOFT_RESET -set Q << 1 ; Inactive reset 

K_POWER_DWN -set 0 << 0 ; Power down external 

K_REG_HIGH_6 «Set K_DGTL_CNF. ADDR|K ADC. DAC|K FSD. OUT |K 16_BIT_COMM 

K_REG_LOW_6 -set K_SECND COMM |K SOFT. RESET |K POWER_DWN 

K_REG_6 set K_REG_HIGH 6|K REG_LOW_6 

K_FRME_SYN_ADDR -set 7 << 8 ; Register 7 address 

K_FRME_SYN -set Q << 8 H 

K_REG_7 -set K_FRME_SYN ADDR |K FRME_SYN 

K_FRME_NUM_ADDR .set 8 << 8 ; Register 8 address 

K_FRME_NUM -set 0 << 8 ; 

K_REG_8 -set K_FRME_NUM_ADDR|K_FRME_NUM 


Ne Ne Ne 


primary word with DO1 and DOO bits set to 11 will cause a 
secondary communications interval to start when the frame 
sync goes low next 


K_SCND_CONTRL .set 11b << 0 ; Secondary comm.bits 
AIC_REG_START_LIST .sect "aic_reg” ; includes the aic table 

-word AIC_REG_END_LIST-AIC_REG_START_LIST-1 

-word K_REG_1 

-word K_REG_2 

-word K_REG_3 

.-word K_REG_4 

.-word K_REG_5 

-word K_REG_6 

-word K_REG_7 

.-word K_REG_8 
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Example 8. *AC01 Initialization (Continued) 


AIC_REG_END_LIST 


K_XRDY .set 0800h ; XRDY bit in SPC1l 
-sect "ave uenig”™ 
aie. Ant: 
CALLD wrt_cnfg ; initialize ACO1 
ANDM # (~K_RINT1),IMR ; disable receive_intl 
ORM #(K_RINT1|K_INT1),IMR ; enable the RINT1, INT1 
RETD 
ST #(K_RINT1),IFR ; service any pending interrupt 
.end 


Example 9. °AC0O1 Register Configuration 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 
Archives: PVCS 
Filename: aic_cfg.asm 
Version: 10 
Status : draft ( ) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
i{ 


, 

’ 

, 

id 

a 

ty 

’ 

’ 

id 

La 

; AUTHOR Padma P. Mallela/Ramesh A. Iyer 
’ 

¥ 

rg 

’ 

, 

id 

 g 

; IPR statements description (can be collected). 
" 
ia 


C) Copyright 1996. Texas Instruments. All rights reserved. 


, 
y 
; Change history: 
’ 
, 


; VERSION DATE / AUTHORS COMMENT 
dl. 20 July-25-96 / P.Mallela original created 


ale ABSTRACT 
1.1 Function Type 
a.Core Routine 
b.Subroutine 
1.2 Functional Description 
This file contains the ACO1 initialization 


1.3 Specification/Design Reference (optional) 


1.4 Module Test Document Reference 
Not done 
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Example 9. *AC0O1 Register Configuration (Continued) 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s aic_cfg.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 

-mmregs 

- include "ale C&G .ine* 
3.2 External Data 
3.3 Import Functions 


aha ed 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


4.5 Export Functions 
.def wrt_cnfg 


5. SUBROUTINE COD 
HeaderBegin 


GI 


5.1 wrt_cnfg 


5.2 Functional Description 
Writes new configuration data into the ACO1. Assuming a system 
which processes speech signals and * requires the following parameters 
Low pass filter cut-off frequency = 3.6 kHz 
Sampling rate = 8000 Hz 
Assume the Master clock MCLK = 10.368 MHz 
This example demonstrates how to program these parameters —- 
the registers affected are: 
Register A which determines the division of the MCLK frequency 
to generate the internal filter clock FCLK. 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 9. "AC01 Register Configuration (Continued) 


; It also determines the -3 dB corner frequency of the low-pass filter 
; Register B which determines the division of FCLK to generate 

; the sampling (conversion) frequency 

; It also determines the -3dB corner frequency of the high-pass filter 


; 5.3 Activation 
; Activation example: 
H CALLD wrt_cnfg 


; STM #K_RINT1,IFR 

’ 

H Reentrancy: No 

; Recursive : No 

7 

H 5.4 Inputs 

; NONE 

7 

; 5.5 Outputs 

; NONE 

7 

7 5.6 Global 

H Data structure: AR1 

H Data Format: 16-bit pointer 
; Modified: No 

7 Description: indexes the table 


A 5.7 Special considerations for data structure 


; 5.8 Entry and Exit conditions 


H DP | OVM|SXM|C16|FRCT|]ASM]ARO|]AR1/AR2/AR3]AR4|/AR5/AR6/AR7/A |B |BK|BRC| T|]TRN 
jin |U 1 1 |NU A. NU |NU |NU |NU |NU |NU |NU |NU_ |NU_ |NU/NU/|NU|NU_ |NU|NU 
7out]U 1 1 |NU 1 NU |NU |UM |NU |NU |UM |NU |NU |NU |UM/|NU|NU|UM |NU|NU 
; Note : UM - Used & Modified, U - Used, NU - Not Used 


; 5.9 Execution 
; Execution time: ?cycles 


; Call rate: not applicable for this application 
; HeaderEnd 
; 5.10 Code 
; 
7 
-asg AR1,AIC_REG_P 
«SECE "aic_cnfg” 
wrt_cnfg: 
STM #aic_reg_tble,AIC_REG_P ; init ARI1 
RPT #AIC_REG_END_LIST-AIC_REG_START_LIST 
MVPD #AIC_REG_START_LIST, *AIC_REG_P+ 7 move the table 
STM #aic_reg_tble,AIC_REG_P ; init ARI1 
STM #K_REG_0,DXR1 ; primary data word -— 


7; a jump start! 
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wait_xrdy 


BIE 
BC 
STM 


LD 
STLM 


RPTB 


wait_xrdyl 


BITF 
BC 
LD 
STLM 


wait_xrdy2 


BITF 
BC 
STM 


SPC 
wal 


#K_ 


*AT 
A, 


NOP 
aic 


SPC 
wal 
*AT 
A, 


SPC 
wal 


#K_ 


aic_cfg_complte 
wait_xrdy3 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Ne Ne Ne Ne Ne Ne Ne Ne NS 


{ 


i} 
7 ( 


{ 


(hm Sa 


38 


BITE 
BC 
RET 


T 


SPC 
wal 


Example 9. ’AC01 Register Configura 


1,K_XRDY 
t_xrdy,NTC 
SCND_CONTRL, DXR1 


Ne Ne Ne Ne Ne 


C_REG_P+,A 


BRC 7 


_cfg_complte-1 


1,K_XRDY : 
t_xrdyl1,NTC 7 
C_REG_P+,A ; 
DXR1 


1,K_XRDY 
t_xrdy2,NTC 
SCND_CONTRL, DXR1 


Ne Ne Ne Ne 


1,K_XRDY ; 
t_xrdy3,NTC ; 


Example 10. Receive Interrupt Se 


EXAS INSTRUMENTS INCORPORATED 


DSP Data Communication System Development / ASP 


Archives: 
Filename: 


Version: 
Status 


AUTHOR 


IPR statements description 


Wy TEXAS 
INSTRUMENTS 


tion (Continued) 


test XRDY bit in SPC1l 

loop if not set 

send primary word with 

DO1-DO00 11 to 

signify secondary communication 


gives the # of registers to be 
initialized 


test XRDY bit in SPC1l 
loop if not set 
Read the register contents 


test XRDY bit in SPCl 

loop if not set 

set to read the next register 
contents 


test XRDY bit in SPC1l 
loop if not set 


rvice Routine 


PVCS 

rev_intl.asm 

12:0 

draft ( ) 

proposal (X) 

accepted ( ) dd-mm-yy/?acceptor. 
Padma P. Mallela 


Application Specific Products 
Data Communication System Development 


12 
st 


203 SW Freeway, 
afford, TX 77477 


MS 701 


(can be collected). 


C) Copyright 1996. Texas Instruments. All rights 
Change history: 
VERSION DATE / AUTHORS 
14:0 July-29-96 / P.Mallela fe) 
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reserved. 


COMMENT 
riginal created 
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Example 10. Receive Interrupt Service Routine (Continued) 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains interrput service routine INTI1: 
receive_intl 

1.3 Specification/Design Reference (optional) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s rcv_intl.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


} 


{ 
3 EXTERNAL RESOURCES 


3.1 Include Files 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


-mmregs 
-include “INTERRPT.INC” 
-include "main.inc” 

; 3.2 External Data 
.ref d_frame_flag 
.cef d_index_count 
.ref d_rcv_in_ptr,d_xmt_out_ptr 
.ref RCV_INT1_DP 


: 3.3 Import Functions 
i} 
i{ 
4 INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 
.def receive_intl 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 10. Receive Interrupt Service Routine (Continued) 


SUBROUTINE CODE 
HeaderBegin 


receive_intl 


Functional Description 

This routine services receive interrupt1l. Accumulator A, AR2 and AR3 

are pushed onto the stack since AR2 and AR3 are used in other 
applications. A 512 buffer size of both input and output uses circular 
addressing. After every 256 collection of input samples a flag is set to 
process the data. A PING/PONG buffering scheme is used such that upon 
processing PING buffer, samples are collected in the PONG buffer and vice 
versa. 


Activation 

Activation example: 
BD receive_intl 
PSHM STO 
PSHM STI 


Reentrancy: No 
Recursive : No 


Inputs 
NONE 


Outputs 
NONE 


5.6 Global 


Data structure: 


Data Format: 
Modified: 
Description: 


AR2 

16-bit input buffer pointer 

Yes 

either point to PING/PONG buffer. Upon entering 

AR2 is pushed onto stack and the address is restored 
through d_rcev_in_ptr 


Data structure: AR3 

Data Format: 16-bit output buffer pointer 

Modified: Yes 

Description: either point to PING/PONG buffer. Upon entering 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data structure: 


Data structure: 


AR3 is pushed onto stack and the address is restored 
through d_rcv_in_ptr 


d_index_count 

16-bit var 

Yes 

holds the number samples that has been collected from 
ACO1 


d_frame_flag 

16-bit variable 

Yes 

flag is set if 256 samples are collected 
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; Data structure: d_rcv_in_ptr 

; Data Format: 16-bit var 

7 Modified: Yes 

; Description: holds the input 
; sample is stored 
 d 

; Data structure: d_xmt_out_ptr 

7 Data Format: 16-bit variable 
7 Modified: Yes 

; Description: 

, 

, 


in |U dl ail 


out |U il al 


Note : UM - Used 


SPRA673 


Example 10. Receive Interrupt Service Routine (Continued) 


buffer address where the newest 


holds the output buffer address where the oldest 


sample is sent as output 


5.8 Entry and Exit conditions 


NU A NU |NU |NU |U U 


NU 1 NU |NU |NU |U U 


5.9 Execution 
Execution time: ?cycles 


5.7 Special considerations for data structure 


DP | OVM| SXM|C16|FRCT|ASM]ARO|]AR1/AR2/AR3/AR4|/AR5|/AR6|AR7|A |B |BK|BRC| T|TRN 


NU |NU |NU |NU |U |NU/NU/NU_ |NU/|NU 


NU |NU |NU |NU |U |NU|U |NU |NU/NU 


& Modified, U - Used, NU - Not Used 


Call rate: not applicable for this application 
; HeaderEnd 
; 5.10 Code 
-asg AR2,GETFRM_IN_P ; get frame input data pointer 
-asg AR3,GETFRM_OUT_P ; get frame output data pointer 
-asg AR2, SAVE_RSTORE_AR2 
-asg AR3, SAVE_RSTORE_AR3 
-sect "main_prg” 
receive_intl: 
PSHM AL 
PSHM AH 
PSHM AG 
PSHM SAVE_RSTORE_AR2 
PSHM SAVE_RSTORE_AR3 
PSHM BK 
PSHM BRC 
STM #2*K_ FRAME SIZE,BK ; circular buffr size of in,out 
; arrays 
LD #RCV_INT1_DP, DP ; init. DP 
MVDK d_rcev_in_ptr,GETFRM_IN_P ; restore input circular bffr ptr 
MVDK d_xmt_out_ptr, GETFRM_OUT_P ; restore output circular bffr ptr 
ADDM #1,d_index_count ; increment the index count 
LD #K_FRAME _SIZE,A 
SUB d_index_count, A 
BC get_samples, AGT ;check for a frame of samples 
frame_flag_set 
ST #K_FRAME FLAG,d_frame_flag ; set frame flag 
ST #0,d_index_count ; reset the counter 
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Example 10. Receive Interrupt Service Routine (Continued) 


get_samples 


Wy TEXAS 
INSTRUMENTS 


LDM DRR1,A ; load the input sample 

STL A, *GETFRM_IN_P+% ; write to buffer 

LD *GETFRM_OUT_P+%,A ; if not true, then the filtered 
AND #O0fffch,A ; signal is send as output 

STLM A,DXR1 ; write to DXR1 

MVKD GETFRM_IN_P,d_rcv_in_ptr ; save input circualr buffer ptr 
MVKD GETFRM_OUT_P,d_xmt_out_ptr ; Save out circular bffr ptr 
POPM BRC 

POPM BK 

POPM SAVE_RSTORE_AR3 

POPM SAVE_RSTORE_AR2 

POPM AG 

POPM AH 

POPM AL 

POPM Sir. 

POPM STO 

RETE ; return and enable interrupts 


Example 11. Task Scheduling 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: task.asm 
Version: 1.0 
Status : draft ( ) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-29-96 / P.Mallela original created 


1. ABSTRACT; 

-1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file initiates task scheduling 


1.3 Specification/Design Reference (optional) 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne SN 
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Example 11. Task Scheduling (Continued) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s task.asm 


1.6 Notes and Special Considerations 


This code is written for 541 device. The code is tested on C54x EVM 


a 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


- include “init_54x.inc” 
- include "“main.inc” 
H 3.2 External Data 
.ref d_task_addr,d_task_init_addr 
.ref d_buffer_count 
.ref present_command 
.ref last_command 
.ref d_output_addr, d_input_addr 
.ref input_data, output_data 
«ret d_frame_flag 
.ref task_init_list,task_list 
H 3.3 Import Functions 
.ref echo_task 
.ref fir_init, fir_task 
-ref do_nothing,no_echo_init_task 
.ref fir_init, fir_task 
.ref iir_init,iir_task 
<net sym_fir_task,sym_fir_init 
.ref adapt_init, adapt_task 
.ref rfft_task 


(phy pe: 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 11. Task Scheduling (Continued) 


; 4.5 Export Functions 
-def task_handler 


5. SUBROUTINE CODE 
HeaderBegin 


5.1 task_handler 


5.2 Functional Description 
This routine handles the task scheduling. The present_command 
can take values 1,2,3,4,5,6. If 
present_command = Echo program is enabled 
present_command = - FIR is enabled 
present_command = - IIR is enabled 
present_command = Symmetric FIR is enabled 
present_command = - > Sees fitler is enabled 
present_command = FFT is enabled 
For every cycle the program checks if the current task is same 
as previous task if it is, then no initialization is done. 
If its not then cirular buffers, variables pointers are intialized 
depending upon the task. 


DURWNES 
| 


5.3 Activation 
Activation example: 


CALL task_handler 
Reentrancy: No 
Recursive : No 
5.4 Inputs 
Data structure: present_command 
Data Format: 16-bit variable 
Modified: Yes 
Description: holds the present command 


5.5 Outputs 


Data structure: AR6 


Data Format: 16-bit input buffer pointer 

Modified: Yes 

Description: either point to PING/PONG buffer 

Data structure: AR7 

Data Format: 16-bit output buffer pointer 

Modified: Yes 

Description: either point to PING/PONG buffer 
5.6 Global 

Data structure: last_command 

Data Format: 16-bit variable 

Modified: Yes 

Description: holds the last command 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Example 11. Task Scheduling (Continued) 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


d_frame_flag 

16-bit variable 

Yes 

gets reset after 256 samples 


d_buffer_count 

16-bit variable 

Yes 

used to load either PING/PONG bffr addresses 


input_data 

16-bit array 

Yes 

address of the input data buffer 


output_data 

16-bit array 

Yes 

address of the output data buffer 


d_input_addr 

16-bit variable 

Yes 

holds either PING/PONG address 


d_output_addr 

16-bit variable 

Yes 

holds either PING/PONG address 


d_task_addr 

16-bit variable 

Yes 

holds the task program address 


d_task_init_addr 
16-bit variable 
Yes 


holds the task init. address 


5.7 Special considerations for data structure 


5.8 


DP | OVM| SXM|C16|FRCT|ASM|ARO/AR1/AR2 


in |U 


out |U 


Note 


1 1 |NU aL 


1 1 |NU 1 


Entry and Exit conditions 


NU |NU |NU |NU |NU |NU |NU |NU |U 


NU |NU |NU |NU |NU |NU |NU |U U 


UM - Used & Modified, U - Used, NU - Not Used 


5.9 Execution 


Execution time: 
Call rate: 


?cycles 
not applicable for this application 


AR3|AR4/AR5/AR6/AR7/A |B |BK/BRC 


SPRA673 


T| TRN 


NU|]NU|NU|NU |NU|NU 


UM|UM|NU|NU |NU|NU 


HeaderEnd 
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PING/PONG input buffer 
PING/PONG output buffer 


; reset the frame flag 


load PING input address 
load PING output address 
check if PING/PONG address 
needs to be loaded 

PONG input address 

PONG output address 

reset counter 


Ne Ne Ne Ne Ne Ne Ne 


input buffer address 
restore either PING/PONG bffr 
output buffer address 
restore either PING/PONG bffr 


Ne Ne Ne Ne 


; check if PC = LC 
; task_addr should 
contain previous 
PC = LC 
7 call present task 


restore the present command 
loads PC init task 

computes the present task 
save the PC into task_addr 


initializes the present task 


; computes the present task 
save the PC into 


; task_addr 


SPRA673 
Example 11. Task Scheduling (Continued) 
7 5.10 Code 
.asg AR6, INBUF_P ; 
-asg AR7, OUTBUF_P ; 
-sect "task_hnd” 
task_handler: 
; LD #TASK_VAR_DP, DP 
ST #K_0,d_frame_flag 
ADDM #1,d_buffer_count 
LD #input_data,A 
LD #output_data,B 
BITF d_buffer_count,2 
BC reset_buffer_address,NTC 
ADD #K_FRAME SIZE,A 
ADD #K_FRAME SIZE,B 
ST #K_0,d_buffer_count 
reset_buffer_address 
STLM A, INBUF_P 
STL A,d_input_addr 
STLM B, OUTBUF_P 
STL B, d_output_addr 
LD present_command,A 
SUB last_command,A 
BC new_task, ANEQ 
LD d_task_addr,A 
r 
, 
CALA A 
RET 
new_task: 
MVKD present_command,last_command j; 
LD #task_init_list,A H 
ADD present_command,A ; 
REDA d_task_init_addr : 
LD d_task_init_addr,A 
CALA A H 
LD #task_list,A; 
ADD present_command,A 
READA d_task_addr H 
LD d_task_addr,A 
CALA A 
RET 
do_nothing: 
RET 
no_echo_init_task: 
RET 
.end 
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Example 12. Echo the Input Signal 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: echo.asm 
Version: pl) 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


C) Copyright 1996. Texas Instruments. All rights reserved. 


AAS 


Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-24-96 / P.Mallela original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains one subroutines: 
echo_task 
1.3 Specification/Design Reference (optional) 
called by task.asm depending upon the task 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s echo.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 12. Echo the Input Signal (Continued) 


2.3 Local Constants 


ha Rap 


3. EXTERNAL RESOURCES 


3.1 Include Files 

-mmregs 

- include "main.inc” 
3.2 External Data 
3.3 Import Functions 


Ne Ne Ne Ne Ne Ne Ne 


hes shape 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


4.5 Export Functions 
.def echo_task 


5. SUBROUTINE COD 
HeaderBegin 


Gl 


5.1 echo_task 


5.2 Functional Description 
This function reads a sample from either PING/PONG buffer and puts it 
back in the output buffer. This is repeated 256 times i.e., size of the 
frame. The present command in this case is 1. 


5.3 Activation 
Activation example: 


CALL echo_task 
Reentrancy: No 
Recursive : No 
5.4 Inputs 

Data structure: AR6 
Data Format: 16-bit input buffer pointer 
Modified: Yes 
Description: either point to PING/PONG buffer 


5.5 Outputs 


Data structure: AR7 


Data Format: 16-bit output buffer pointer 
Modified: Yes 
Description: either point to PING/PONG buffer 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 12. Echo the Input Signal (Continued) 


5.6 Global 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 

DP | OVM|SXM|C16|FRCT/]ASM]ARO]|]AR1/]AR2|}AR3|AR4|AR5/AR6/AR7/A |B |BK|BRC] T|TRN 
an |. 1 1 |NU 1 NU |NU |NU |NU |NU |NU_ |NU |U U NU|NU|]NU|NU_ |NU|NU 
out |U il 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |UM |UM |UM|NU/|NU|UM |NU|NU 
Note : UM —- Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


Call rate: not applicable for this application 
i. 
HeaderEnd 
5.10 Code 

.asg AR6, INBUF_P ; PING/PONG input buffer 
-asg AR7,OUTBUF_P ; PING/PONG output buffer 
-sect “echo_prg” 

echo_task: 
STM #K_FRAME_ SIZE-1,BRC ; frame size of 256 
RPTB echo_loop-1 
LD *TNBUF_P+, A ; load the input value 
STL A, *OUTBUF_Pt+ 

echo_loop 
RET ; output buffer 


Example 13. Low-Pass FIR Filtering Using MAC Instruction 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: fir.asm 
Version: 1.0 
Status : draft C*) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


Change history: 


TMS320C54x Application Code Examples 49 


SPRA673 


WB TEXAS 
INSTRUMENTS 


Example 13. Low-Pass FIR Filtering Using MAC Instruction (Continued) 


VERSION DATE / 
1.0 July-26-96 / 


1. ABSTRACT 

1.1 Function Type 
a.Core Routine 
b. Subroutine 


1.2 Functional Description 


1) £ir_init 
2) fir_task 


1.3 Specification/Design Reference 
called by task.asm depending upon the task thru CALA 


AUTHORS 
P.Mallela 


This file contains two subroutines: 


1.4 Module Test Document Reference 


Not done 


Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s fir.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


(optional) 


2.1 Definition of Special Words, Keywords (optional) 
2.2 Local Compiler Flags 
2.3 Local Constants 
} 
{ 
3. EXTERNAL RESOURCES 
3.1 Include Files 
-mmregs 
- include "main.inc” 
; 3.2 External Data 
.ref d_filin ; filter input 
.ref d_filout ; filter output 
.ref d_data_buffer 
.ref fir_task 
.ref COFF_FIR_START, COFF_FIR_END 
.ref fir_coff_table 


3.3 Import Functions 


ae a 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


Ne Ne Ne Ne Ne Ne Ne 
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Example 13. Low-Pass FIR Filtering Using MAC Instruction (Continued) 

; 4.2 Global Static Data 

; = 

; 4.3 Dynamic Data 

; _ 

; 4.4 Temporary Data 

; _ 

; 4.5 Export Functions 
.def fir anit ; initialize FIR filter 
-def fir_filter ; perform FIR filtering 

i} 

; 5. SUBROUTINE CODE 

F HeaderBegin 

r 

¥ 

Fr 

; 5. dk. aaa? Ge, 

’ 

; 5.1.1 Functional Description 

; This routine initializes cicular buffers both for data and coeffs. 

¥ 

’ 

; 5.1.2 Activation 

; Activation example: 

- CALL fir init 

‘ Reentrancy: No 

‘ Recursive No 

’ 

7 5.1.3 Inputs 

; NONE 

; 5.1.4 Outputs 

; NONE 

if 

7 5.1.5 Global 

, 

: Data structure: ARO 

‘ Data Format: 16-bit index pointer 

; Modified: No 

7 Description: uses in circular addressing mode for indexing 

, 

; Data structure: AR4 

‘ Data Format: 16-bit x(n) data buffer pointer 

; Modified: Yes 

7 Description: initializes the pointer 

, 

; Data structure: AR5 

7 Data Format: 16-bit w(n) coeff buffer pointer 

; Modified: Yes 

7 Description: initializes the pointer 

’ 

; 5.1.6 Special considerations for data structure 

; _ 

; 5.1.7 Entry and Exit conditions 

if 

7 DP | OVM|SXM|C16|FRCT/ASM]ARO|AR1/AR2/AR3|}AR4|AR5/AR6/AR7/A |B |BK|BRC| T|]TRN 

if 

gain: | U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |UM/NU/|NU|NU_ |NU|NU 

, 

,out]U 1 1 |NU 1 NU |UM |NU |NU |NU |UM |UM |NU |NU |UM|NU/|NU|NU_ |NU|NU 

¥ 

; Note UM - Used & Modified, U - Used, NU - Not Used 
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Example 13. Low-Pass FIR Filtering Using MAC Instruction (Continued) 


5.1.8 Execution 
Execution time: ?cycles 


Ne Ne Ne Ne Ne Ne Ne 


Call rate: not applicable for this application 
’ 

HeaderEnd 

5.1.9 Code 
-asg ARO, FIR_INDEX_P 
-asg AR4,FIR_DATA_P 
-asg AR5,FIR_COFF_P 
-sect "fir prog” 

fir init: 
STM #fir_coff_table,FIR_COFF_P 
RPT #K_FIR_BFFR-1 7 move FIR coeffs from program 
MVPD #COFF_FIR_START, *FIR_COFF_Pt ; to data 
STM #K_FIR_INDEX, FIR_INDEX_P 
STM #d_data_buffer,FIR_DATA P ; load cir_bfr address for the 
; recent samples 

RPTZ A, #K_FIR_BFFR 
STL A, *FIR_DATA P+ ; reset the buffer 
STM # (d_data_buffer+K_FIR_BFFR-1), FIR_DATA_P 
RETD 
STM #fir_coff_table, FIR_COFF_P 

5. SUBROUTINE CODE 

HeaderBegin 


5.2 fir_task 
5.2.1 Functional Description 


This subroutine performs FIR filtering using MAC instruction. 
accumulator A (filter output) = h(n)*x(n-i) for i = 0,1...15 


5.2.2 Activation 
Activation example: 


CALL fir_task 
Reentrancy: No 
Recursive : No 


5.2.3 Inputs 


Data structure: AR6 

Data Format: 16-bit input buffer pointer 

Modified: Yes 

Description: either point to PING/PONG buffer 

Data structure: AR4 

Data Format: 16-bit data buffer pointer 

Modified: Yes 

Description: uses circular buffer addressing mode to filter 
16 tap Low-Pass filter - init. in fir_init 

Data structure: AR5 

Data Format: 16-bit coefficient buffer pointer 

Modified: Yes 

Description: The 16 tap coeffs comprise the low-pass filter 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


AE. en Fate anal 
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Example 13. Low-Pass FIR Filtering Using MAC Instruction (Continued) 


5.2.4 Outputs 


Data structure: AR7 

Data Format: 16-bit output buffer pointer 
Modified: Yes 

Description: either point to PING/PONG buffer 


5.2.5 Global 
NONE 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


5.2.6 Special considerations for data structure 


5.2.7 Entry and Exit conditions 


a 
, 
, 
, 
, 
H DP | OVM| SXM|C16]FRCT|]ASM|]ARO|]AR1]AR2|]AR3/}AR4/AR5|AR6/AR7/A |B |BK|BRC| T|]TRN 
, 

jin |U 1 1 |NU 1 NU |NU |NU |NU |NU |U NU |U U |UM|NU|NU/NU |NU|NU 
i 

;out|U il 1 |NU 1 NU |UM |NU |NU |NU |UM |UM |UM |UM |UM/NU|UM|UM |NU/NU 
, 

; Note : UM - Used & Modified, U - Used, NU - Not Used 

, 

f 

fl 

, 

a 


5.2.8 Execution 
Execution time: ?cycles 


Call rate: not applicable for this application 
, 
; HeaderEnd 
5.2.9 Code 
-asg AR6, INBUF_P 
-asg AR7, OUTBUF_P 
-asg AR4,FIR_DATA P 
-asg AR5,F IR_COFF_P 
-sect "fir prog” 
fir_task: 
; LD #FIR_DP, DP 
STM #K_FRAME _ SIZE-1,BRC ; Repeat 256 times 
RPTBD fir_filter_loop-1l 
STM #K_FIR_BFFR, BK ; FIR circular bffr size 
LD *TNBUF_P+, A ; load the input value 
fir filter: 
STL A, *FIR_DATA_P+% ; replace oldest sample with newest 
7 sample 
RPTZ A, (K_FIR_BFFR-1) 
MAC *FIR_ DATA P+0%,*FIR_COFF_P+0%,A ; filtering 
STH A, *OUTBUF_P+t+ ; replace the oldest bffr value 
fir_filter_loop 
RET 
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Example 14. Low-Pass Symmetric FIR Filtering Using FIRS Instruction 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: sym_fir.asm 
Version: 1.20) 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-26-96 / P.Mallela original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains two subroutines: 
1) sym_fir_init 
2) sym_fir_task 


1.3 Specification/Design Reference (optional) 
called by task.asm depending upon the task thru CALA 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s sym_fir.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne NS 
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Example 14. Low-Pass Symmetric FIR Filtering Using FIRS Instruction (Continued) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCI 


GI 
wn 


Ne Ne Ne Ne Ne Ne Ne Ne Ne 
wa 


3.1 Include Files 
-mmregs 
-include "main.inc” 

; 3.2 External Data 
.ref d_datax_buffer 
.ref d_datay_buffer 
.ref FIR_COFF 

3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


, 
a 
, 
, 
, 
, 
, 
; 4.2 Global Static Data 
, 
, 
, 
, 
, 
id 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 
-def sym_fir_init ; initialize symmetric FIR 
.def sym_fir_task 


5. SUBROUTINE CODE 
HeaderBegin 


ogee sym_fir_init 


5.1.1 Functional Description 
This routine initializes cicular buffers both for data and coeffs. 


5.1.2 Activation 
Activation example: 


CALL sym_fir_init 
Reentrancy: No 
Recursive : No 


5.1.3 Inputs 
NONE 

5.1.4 Outputs 
NONE 


5.1.5 Global 


Data structure: ARO 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Data Format: 16-bit index pointer 
Modified: No 
Description: uses in circular addressing mode for indexing 
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Example 14. Low-Pass Symmetric FIR Filtering Using FIRS Instruction (Continued) 


5.1.6 Special 


;in |U 1 1 |NU 
,;out}U 1 1 |NU 


Note : UM - Used 


Data structure: AR4 


Data Format: 16-bit x(n) data buffer pointer for 8 latest samples 
Modified: Yes 
Description: initializes the pointer 


Data structure: AR5 


Data Format: 16-bit x(n) data buffer pointer for 8 oldest samples 
Modified: Yes 
Description: initializes the pointer 


considerations for data structure 


5.1.7 Entry and Exit conditions 


DP | OVM| SXM|C16|FRCT|]ASM]ARO]AR1/AR2/AR3|/AR4/]AR5/AR6|AR7|A |B |BK|BRC| T|TRN 


i NU |NU |NU |NU |NU |NU |NU |NU |NU |UM|NU|NU|NU |NU|NU 


1 NU |UM |NU |NU |NU |U UM |NU |NU |UM|NU|NU|NU |NU|NU 


& Modified, U - Used, NU - Not Used 


5.1.8 Execution 
Execution time: ?cycles 


’ 
’ 
lf 
’ 
’ 
v 
La 
Ld 
’ 
’ 
4 
v 
Ld 
’ 
r 
La 
’ 
’ 
La 
ts 
’ 
A 
’ 
’ 
La 
Ld 
La 
’ 
4 


Call rate: not applicable for this application 
; HeaderEnd 
: 5.1.9 Code 
asg ARO, SYMFIR_INDEX_P 
asg AR4, SYMFTR_DATX_P 
asg AR5,SYMFIR_DATY_P 
sect "“sym_fir” 
sym_fir_init: 
STM #0_datax_buffer, SYMFIR_DATX_P ; load cir_bfr address 
; for the 8 most 
; recent samples 
STM #d_datay_buffer+K_FIR_BFFR/2-1,SYMFIR_DATY_P 
; load cir_bfrl address 
; for the 8 old samples 
STM #K_negl, SYMFIR_INDEX_P ; index offset - 
; whenever the pointer 
; hits the top of the bffr, 
; it automatically hits 
; bottom address of 
; buffer and decrements 
; the counter 
RPTZ A, #K_FIR_BFFR 
STL A,* SYMFIR_DATX_P+t+ 
STM #d_datax_buffer, SYMFIR_DATX_P 
RPTZ A, #K_FIR_BFFR 
STL A,* SYMFIR_DATY_P- 
RETD 
STM #d_datay_buffer+K_FIR_BFFR/2-1, SYMFIR_DATY_P 


HeaderBegin 


5. SUBROUTINE CODE 


Ne Ne Ne Ne 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


SPRA673 


Example 14. Low-Pass Symmetric FIR Filtering Using FIRS Instruction (Continued) 


-2 sym_fir_init 


filter. 


for the data samples is divided into two circular buffers. 
buffer contains samples from X(-N/2) 
contains samples from X(-N) 


-2.1 Functional Description 
This program uses the FIRS instruction to implement symmetric FIR 
Circular addressing is used for data buffers.The input scheme 
The first 

and the second buffer 


to X(-1) 
to X(-N/2-1). 


Activation 


Activation example: 


CALL 
Reentrancy 
Recursive 


Inputs 


Data struc 
Data Forma 
Modified: 

Descriptio 


Data struc 
Data Forma 
Modified: 

Descriptio 


Data struc 
Data Forma 
Modified: 

Descriptio 


Outputs 


Data struc 
Data Forma 
Modified: 

Descriptio 


Global 
NONE 


DP | OVM| SXM|C16|FRCT]ASM]ARO/]AR1]AR2 


NU 


UM - Used & 


-2.8 Execution 


Execution 
Call rate: 


Eure: 
es 


ne: 


ture: 
es 


ns 


ture: 


Es 


ne: 


ture: 
ee 


ne: 


-2.6 Special considerations for data 


sym_fir_init 
No 
No 


AR6 

16-bit input buffer pointer 

Yes 

either point to PING/PONG buffer 


AR4 

16-bit data buffer pointer 

Yes 

uses circular buffer addressing mode to filter 
16 tap Low-Pass filter - init. in sym_fir_init 


AR5 

16-bit coefficient buffer pointer 

Yes 

The 16 tap coeffs comprise the low-pass filter 


init. in sym_fir_init 

AR7 

16-bit output buffer pointer 
Yes 


either point to PING/PONG buffer 


structure 


-2.7 Entry and Exit conditions 


AR3|}AR4/}AR5/AR6/AR7/A |B |BK|BRC| T|TRN 
1 NU |NU |NU |NU |NU |U U U U |UM|NU|NU|NU |NU|NU 
A NU |UM |NU |NU |NU |UM |UM |NU |NU |UM|UM/NU|UM |NU/NU 
Modified, U - Used, NU - Not Used 
time: ?cycles 


not applicable for this application 
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Example 14. Low-Pass Symmetric FIR Filtering Using FIRS Instruction (Continued) 


Ld 


7 
; HeaderEnd 


: 5.2.9 Code 
-asg AR6, INBUF_P 
-asg AR7, OUTBUF_P 
-asg AR4, SYMFIR_DATX_P 
-asg AR5, SYMFIR_DATY_P 
-sect "sym_fir” 


sym_fir_task: 
STM #K_FRAME_ SIZE-1,BRC 
RPTBD sym_fir_filter_loop-1 
STM #K_FIR_BFFR/2,BK 
LD *INBUF_P+, B 
symmetric_fir: 
MVDD *SYMFIR_DATX_P, *SYMFIR_DATY_P+0% ; move X(-N/2) to X(-N) 
STL B, *SYMFIR_DATX_P ; replace oldest sample with newest 
, 
id 


sample 
ADD * SYMFIR_DATX_P+0%, *SYMFIR_DATY_P+0%,A add X(0)+X(-N/2-1) 
RPTZ B,#(K_FIR_BFFR/2-1) 


FIRS *SYMFIR_DATX_P+0%,*SYMFIR_DATY_P+0%,FIR_COFF 


MAR *+SYMFTIR_ DATX_P(2)% ; to load the next newest sample 
MAR *SYMFIR_DATY_P+% ; position for the X(-N/2) sample 
STH B, *OUTBUF_Pt+ 


sym_fir_filter_loop 
RET 
.end 


Example 15. Low-Pass Biquad IIR Filter 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: iir.asm 
Version: 1.0 
Status : draft C.) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR: Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-26-96 / P.Mallela original created 


Ne Ne Ne Ne Ne Ne Ne Ne NS 


(hm Sa 
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Example 15. Low-Pass Biquad IIR Filter (Continued) 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains two subroutines: 
1 tae ana’ 
2) iir_task 
1.3 Specification/Design Reference (optional) 
called by task.asm depending upon the task thru CALA 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s iir.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


-mmregs 
-include "main.inc” 
; 3.2 External Data 
.ref d_iir_y 
.ref d_iir_d 
.ref iir_table_start,iir_coff_table 


3.3 Import Functions 


ae 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


4.5 Export Functions 
.def Lie inst 
.def iir_task 
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DP | OVM| SXM|C16|FRCT]ASM]ARO|]AR1/AR2/AR3|/AR4/]AR5/AR6|AR7|A |B |BK|BRC| T|TRN 


;in |U 


,;out|U 


Note 


1 


dl 


1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |UM|NU|NU|NU |NU|NU 


1 |NU 1 NU |NU |NU |NU |NU |UM |UM |NU |NU |UM|NU|NU|UM |UM|NU 


UM - Used & Modified, U - Used, NU - Not Used 


5.1.8 Execution 


Execution time: ?cycles 


SPRAG673 INSTRUMENTS 
Example 15. Low-Pass Biquad IIR Filter (Continued) 

i} 

; 5. SUBROUTINE CODE 

; HeaderBegin 

, 

, 

, 

’ Sell alae, alae 

, 

5.1.1 Functional Description 

‘ A) This routine initializes buffers both for data and coeffs. 

, 

, 

F 5.1.2 Activation 

Activation example: 

f CALL ear Ae 

i, Reentrancy: No 

F Recursive : No 

lA 

7 5.1.3 Inputs 

; NONE 

; 5.1.4 Outputs 

; NONE 

; 5.1.5 Global 

H NONE 

; 5.1.6 Special considerations for data structure 

, 

F 5.1.7 Entry and Exit conditions 

, 

, 

, 

, 

lA 

, 

, 

, 

r 

, 

, 

, 

, 

, 

, 


Call rate: not applicable for this application 
; HeaderEnd 
5.1.9 Code 
-asg AR5,IIR_DATA_P ; data samples pointer 
-asg AR4, I IR_COFF_P ; IIR filter coffs pointer 
-sect os ba 
iir init: 
STM #iir_coff_table, IIR_COFF_P 
RPT #K_IIR_SIZE-1 7; move IIR coeffs from program 
MVPD #iir_table_start, *IIR_COFF_P+t ; to data 
LD #IIR_DP,DP 
ST #d_iir_d, IIR_DATA_P ;AR5:d(n),d(n-1),d(n-2) 
RPTZ A,#5 ;initial d(n),d(n-1),d(n-2)=0 
STL A, *IIR_DATA_P+t 
RET 
5. SUBROUTINE CODE 


HeaderBegin 


Ne Ne Ne Ne 
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Example 15. Low-Pass Biquad IIR Filter (Continued) 


52.2 dar task 
5.2.1 Functional Description 


This subroutine performs IIR filtering using biquad sections 
IIR Low pass filter design 

Filter type : Elliptic Filter 

Filter order : 4 order (cascade: 2nd order + 2nd order) 

cut freq. of pass band : 200 Hz 

cut freq. of stop band : 500 Hz 


7 

, 

, 

, 

; 

7 

7 

7 

; 

7 

, 

; BO 

; > + > d(n) x -> + 

: | 

; Al | Bl | 

; + <- xX d(n-1) > i am a 

; | 

; | A2 | B2 | 

7 + <- xX d(n-2) xX —> + 

, 

; second order IIR 

; 

7 

7 5.2.2 Activation 

; Activation example: 

A CALL iir_task 

H Reentrancy: No 

; Recursive : No 

, 

A 5.2.3 Inputs 

r 

7 Data structure: AR6 

7 Data Format: 16-bit input buffer pointer 
: Modified: Yes 

: Description: either point to PING/PONG buffer 
a 

; 5.2.4 Outputs 

, 

7 Data structure: AR7 

7 Data Format: 16-bit output buffer pointer 
; Modified: Yes 

7 Description: either point to PING/PONG buffer 
, 

H 5.2.5 Global 

H Data structure: AR1 

; Data Format: 16-bit index counter 

: Modified: Yes 

7 Description: checks if 256 samples are processed 
, 

7 Data structure: AR5 

; Data Format: 16-bit data buffer pointer 

7 Modified: Yes 

7 Description: inlcudes both feed forward and feedback paths 
, 

; Data structure: AR4 

; Data Format: 16-bit coefficient buffer pointer 
; Modified: Yes 

; Description: contains 2 biquad sections 

a 
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Data 
Modi 
Desc 


4 TEXAS 


INSTRUMENTS 
Example 15. Low-Pass Biquad IIR Filter (Continued) 
structure: d_iir_y 
Format: 16-bit variable 
fied: Yes 
ription: holds the output of the 2 biquad sections 


5.2.6 Special considerations for data structure 


5.2.7 Entr 


DP | OVM| SXM|C16]|FRCT]ASM]ARO/]AR1/AR2 


,;out|U 1 1. 


y and Exit conditions 


NU 1 NU |NU |NU |NU |NU 


NU 1 NU |NU |UM |NU_ |NU 


AR3]AR4/AR5/AR6/AR7/A |B |BK|BRC] T|TRN 
NU |NU |U U UM|NU|NU|NU |NU|NU 


UM |UM |UM |UM |UM/NU/NU/]UM |UM|NU 


, 
, 
, 
, 
, 
, 
, 
, 
, 
, 
, 
jin |U 1. 1 
, 
, 
r 
, 
, 
, 
, 
, 
, 
¥ 


Note : UM - Used & Modified, U - Used, NU - Not Used 
5.2.8 Execution 
Execution time: ?cycles 
Call rate: not applicable for this application 
; HeaderEnd 
5.2.9 Code 
-asg AR5, IIR_DATA_P ; data samples pointer 
-asg AR4, IIR_COFF_P ; IIR filter coffs pointer 
-asg AR6, INBUF_P 
-asg AR7,OUTBUF_P 
-asg AR1, IIR_INDEX_P 
-sect eg age 
iir_task: 
STM #K_FRAME SIZE-1,BRC ; Perform filtering for 256 samples 
RPTB iir_filter_loop-1 
LD *TNBUF_P+,8,A ; load the input value 
iir_filter: 
STM #d_iir_d+5,IIR_DATA P ;AR5:d(n),d(n-1),d(n-2) 
STM #iir_coff_table, IIR_COFF_P ;AR4:coeff of IIR filter 
A2,A1,B2,B1,B0 
STM #K_BIQUAD-1, IIR_INDEX_P 
feedback_path: 
MAC *TIR_COFF_P+,*IIR_DATA P-,A ;inputt+d(n-2) *A2 
MAC *TIR_COFF_P, *IIR_DATA_P,A ;inputt+d(n-2) *A2+d(n-1) *A1/2 
MAC *TIR COFF P+,*IIR DATA P-,A ; A = At+d(n-1) *Al1/2 
STH A, *IIR_DATA_P+t 7d(n) = inputt+td(n-2) *A2+d(n-1) *Al1 
MAR *TIR_DATA Pt 
* Forward path 
MPY *TIR_COFF_P+,*IIR_DATA P-,A ;d(n-2) *B2 
MAC *TIR_COFF_P+,*IIR_DATA P,A ;d(n-2) *B2+d(n-1) *B1 
DELAY *TIR_DATA P- ;d(n-2)=d(n-1) 
eloop: 
BANZD feedback_path, *IIR_INDEX_P- 
MAC *TIR_COFF_P+,*IIR_DATA P,A 7;d(n-2) *B2+d(n-1) *B1+d(n) *BO 
DELAY *TIR_DATA P- ;d(n-1)=d(n) 
STH A,d_iir_y ; output=d(n-2) *B2+d(n-1) *B1l+d(n) *BO 
LD d_iir_y,2,A 7 scale the output 
STL A, *OUTBUF_P+ 7 replace the oldest bffr value 
iir_filter_loop 
RET 
.end 
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Example 16. Adaptive Filtering Using LMS Instruction 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: adapt.asm 
Version: 1.0 
Status : draft (-) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 

Data Communication System Development 
12203 SW Freeway, MS 701 

Stafford, TX 77477 


{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-24-96 / P.Mallela original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains two subroutines: 
1) adapt_init 
2) adapt_task 
1.3 Specification/Design Reference (optional) 
called by task.asm depending upon the task 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s adapt.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne NS 
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Example 16. Adaptive Filtering Using LMS Instruction (Continued) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne 
a 


3.1 Include Files 


-mmregs 
.- include "main.inc” 

H 3.2 External Data 

; .ref ADAPT_DP 
.ref d_mu, d_error,d_primary, d_output, d_mu, d_mu_e, d_new_x 
.ref scoff, hcoff,wcoff 
.ref xh, xw, d_adapt_count 


3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 
.def adapt_init, adapt_task 


5. SUBROUTINE COD 
HeaderBegin 


GI 


5.1 adapt_init 
5.1.1 Functional Description 
This subroutine moves filter coeffcients from program to data space. 


Initializes the adaptive coefficients, buffers,vars,and sets the circular 
buffer address for processing. 


5.1.2 Activation 
Activation example: 


CALL adapt_init 
Reentrancy: No 
Recursive : No 


5.1.3 Inputs 
NONE 


5.1.4 Outputs 
NONE 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 16. Adaptive Filtering Using LMS Instruction (Continued) 


5.1.5 Global 
Data structure: ARO 


Data Format: 16-bit index pointer 
Modified: No 
Description: uses in circular addressing mode for indexing 


Data structure: ARI 


Data Format: 16-bit pointer 
Modified: Yes 
Description: used in initializing buffers and vars 


Data structure: AR3 


Data Format: 16-bit x(n) data buffer pointer for H(z) 
Modified: Yes 
Description: initializes the pointer 


Data structure: AR5 


Data Format: 16-bit x(n) data buffer pointer for W(z) 
Modified: Yes 
Description: initializes the pointer 


5.1.6 Special considerations for data structure 


5.1.7 Entry and Exit conditions 


DP | OVM| SXM|C16|FRCT|ASM]ARO|]AR1/AR2/AR3/AR4|/AR5|/AR6|AR7|A |B |BK|BRC| T|]TRN 


in |U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU |NU |UM|NU|NU|NU |NU|NU 


out |U al 1 |NU 1 NU |UM |UM |NU |UM |NU |UM |NU |NU_ |UM/UM|NU|NU |NU/NU 
Note : UM - Used & Modified, U - Used, NU - Not Used 


5.1.8 Execution 
Execution time: ?cycles 
Call rate: not applicable for this application 


; HeaderEnd 

5.1.9 Code 
-asg ARO, INDEX_P 
-asg AR1, INIT_P 
-asg AR3, XH_DATA_P 
-asg AR5, XW_DATA_P 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


initialize buffer pointer 
data coeff buffer pointer 
data coeff buffer pointer 
for cal.y output 


Ne Ne Ne Ne 


-sect "filter” 
adapt_init: 
. initialize input data location, input to hybrid, with Zero. 


STM #xh, INIT_P 
RPTZ A, #H_FILT_SIZE-1 
STL A, *INIT_P+t 
4 initialize input data location, input to adaptive filter, with Zero. 
STM #xw, INIT_P 
RPTZ A, #ADPT_FILT_SIZE-1 
STL A, *INIT_P+t 
; initialize adaptive coefficient with Zero. 
STM #wcoff, INIT_P 
RPTZ A, #ADPT_FILT_SIZE-1 
STL A, *INIT_P+t 
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Example 16. Adaptive Filtering Using LMS Instruction (Continued) 


initialize temporary storage loacations with zero 


STM #d_primary, INIT_P 
RPTZ A, #6 
STL A, *INIT_Pt+ 
copy system coefficient into RAM location, Rverse order 
STM #hcoff, INIT_P 
RPT #H_FILT_SIZE-1 
MVPD #scoff, *INIT_P+ 
LD #ADAPT_DP, DP ;7set DP now and not worry about it 
ST #K_mu, d_mu 
STM #1, INDEX_P ; increment value to be used by 


; Qual address 


associate auxilary registers for circular computation 


STM #xh+H_FILT_SIZE-1,XH_DATA_P ; last input of hybrid buffer 
RETD 
STM #xXW+ADPT_FILT_SIZE-1,XW_DATA_P ;last element of input buffer 
5. SUBROUTINE CODE 
HeaderBegin 
Did adapt_task 


5.2.1 Functional Description 


This subroutine performs the adaptive filtering.The newest sample is 
stored in a seperate location since filtering and adaptation are performed 
at the same time. Otherwise the oldest sample is over written before 

up dating the w(N-1) coefficient. 


d_primary = xh *hcoff 


d_output = xw *wcoff 
LMS algorithm: 

w(itl) = w(i)+d*mu_error*xw(n-i) for i = 0,1,...127 and n = 0,1,..... 
This program can run in two steps 
1. Initial stepsize, d_mu = 0x0. At this point, the system is not 
identified since the coefficients are not adapted and the error 
signal e (n) is d (n). This is the default mode 


2. At the EVM debugger command window change the step size 

d_mu — 0x000, with the command e * d_mu = 0x1000 

This changes the stepsize. The error signal e(n) in this case 

is approximately 0 (theoretically) and the system is identified. 


5.2.2 Activation 


Activation example: 


CALL adapt_task 
Reentrancy: No 
Recursive : No 


5.2.3 Inputs 


Data structure: AR3 


Data Format: 16-bit x(n) data buffer pointer for H(Z) 
Modified: Yes 
Description: uses circular buffer addressing mode of size 128 


Data structure: ARD5 


Data Format: 16-bit x(n) data buffer pointer for W(z) 
Modified: Yes 
Description: uses circular buffer addressing mode of size 128 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Data structure: 


Data Format: 
Modified: 
Description: 


-4 Outputs 


Data structure: 


Data Format: 
Modified: 
Description: 


-5 Global 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


Data structure: 


AR6 

16-bit input buffer pointer 

Yes 

either point to PING/PONG buffer 


AR7 

16-bit output buffer pointer 

Yes 

either point to PING/PONG buffer 


AR2 

16-bit H(z) coeff buffer pointer 

Yes 

uses circular buffer addressing mode of size 


AR4 

16-bit W(z) coeff buffer pointer 

Yes 

uses circular buffer addressing mode of size 


d_adapt_count 

16-bit variable 

Yes 

counter to check for processing 256 samples 


d_new_x 

16-bit variable 

Yes 

holds the newest sample 


d_primary 

16-bit variable 

Yes 

d_primary = xh * hcoeff 


d_output 

16-bit variable 

Yes 

d_output = xw * wcoff 


d_error 

16-bit variable 

Yes 

d_error = d_primary-d_output 


d_mu_e 

16-bit variable 

Yes 

d_mu_e = mu*d_error 


5.2.6 Special considerations for data structure 


5.2.7 Entry and Exit conditions 


128 


128 


TMS320C54x Application Code Examples 


67 


vy TEXAS 


SPRAG673 INSTRUMENTS 


Example 16. Adaptive Filtering Using LMS Instruction (Continued) 


DP | OVM| SXM|C16|FRCT]ASM]ARO]AR1/AR2/AR3|/AR4/]AR5/AR6|AR7|A |B |BK|BRC| T|TRN 
in |U 1 1 |NU 1 NU |U NU |NU |U NU Uo VU U |UM|NU|NU|NU |NU/|NU 


out |U 1 1 |NU 1 NU |U NU |UM |UM |UM |UM |UM |UM |UM|UM|UM/UM |UM|NU 
Note : UM - Used & Modified, U - Used, NU - Not Used 


5.2.8 Execution 
Execution time: ?cycles 


Call rate: not applicable for this application 
HeaderEnd 
5.2.9 Code 
-asg AR2,H_COFF_P ; H(Z) coeff buffer pointer 
-asg AR3, XH_DATA_P ; data coeff buffer pointer 
-asg AR6, INBUF_P ; input buffer address pointer 
.asg AR7, OUTBUF_P ; output buffer address pointer 
; for cal. primary input 
-asg AR4,W_COFF_P ; W(z) coeff buffer pointer 
-asg AR5, XW_DATA_P ; data coeff buffer pointer 
-sect “filter” 
adapt_task: 
STM #H_FILT_SIZE, BK ; first circular buffer size 
STM #hcoff,H_COFF_P ; H_COFF_P --> last of sys coeff 
ADDM #1,d_adapt_count 
LD *INBUF_P+, A ; load the input sample 
STM #wcoff,W_COFF_P ; veset coeff buffer 
STL A, d_new_x ; read in new data 
LD d_new_x,A H 
STL A, *XH_DATA_P+0% ; store in the buffer 
RPTZ A, #H_FILT_SIZE-1 ; Repeat 128 times 
MAC *H COFF_P+0%,*XH_DATA P+0%,A ; mult & acc:a = a+ (h * x) 
STH A,d_primary ; primary signal 
H start simultaneous filtering and updating the adaptive filter here. 
LD d_mu_e,T ; T = step_size*error 
SUB B,B 7; zero acc B 
STM # (ADPT_FILT_SIZE-2),BRC 7 set block repeat counter 
RPTBD lms_end-1 
MPY *XW_DATA_P+0%, A ; error * oldest sample 
LMS *W_COFF_P, *XW_DATA_P ; B = filtered output (y) 
; Update filter coeff 
ST A, *W_COFF_P+t+ ; save updated filter coeff 
| | MPY*XW_DATA P+03%,A ; error *x[n-(N-1)] 
LMS *W_COFF_P, *XW_DATA_P 7; B = accum filtered output y 
; Update filter coeff 
ims_end 
STH A, *W_COFF_P ; final coeff 
MPY *XW_DATA_P,A ; x(0)*h(0) 
MVKD #d_new_x, *XW_DATA_P 7 store the newest sample 
LMS *W_COFF_P, *XW_DATA_P+0% 
STH B, d_output ; store the fitlered output 
LD d_primary,A 
SUB d_output,A 
STL A, d_error ; store the residual error signal 
LD d_mu, T 
MPY d_error,A ; A=u*e 
STH A,d_mu_e ; save the error *step_size 
LD d_error,A ; residual error signal 
STL A, *OUTBUF_Pt+ 
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Example 16. Adaptive Filtering Using LMS Instruction (Continued) 


LD #K_FRAME _ SIZE,A ; check if a frame of samples 
SUB d_adapt_count,A ; have been processed 

BC adapt_task, AGT 

RETD 

ST #K_0,d_adapt_count ; restore the count 

.end 


* This is an input file used by the adaptive filter program. 
* The transfer function is the system to be identifued by the adaptive filter 


.-word OFFFDh 
.-word 24h 
-word 6h 
-word OFFFDh 
.-word 3h 
.-word 3h 
-word OFFE9Qh 
-word 7h 
.-word 12h 
.-word 1Ch 
-word OFFF3h 
-word OFFE8h 
-word OCh 
.-word 3h 
-word 1Eh 
-word 1Ah 
-word 22h 
.-word OFFF5h 
.-word OFFESh 
-word OFFFih 
.word OFFC5Sh 
.word OCh 
-word OFFE8h 
-word 37h 
-word OFFE4h 
-word OFFCAh 
.-word Ch 
-word OFFFDh 
-word 21h 
-word OFFF7h 
.-word 2Eh 
.-word 28h 
-word OFFC6h 
-word 53h 
.word OFFBOh 
.word 55h 
-word OFF36h 
.-word 5h 
-word OFFCFh 
-word OFF99h 
-word 64h 
-word 4ih 
-word OFFF1ih 
.-word OFFDFh 
.-word OD1ih 
.word 6Ch 
.-word 57h 
-word 36h 
.-word OAOh 
-word OFEE3h 
-word 6h 
-word OFEC5Sh 
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.word 
-word 
-word 
.-word 
.word 
-word 
-word 
.word 
.-word 
.-word 
.word 
.-word 
.-word 
.word 
.-word 
.word 
.word 
-word 
-word 
.word 
.-word 
.-word 
.word 
-word 
-word 
.word 
.-word 
-word 
-word 
.word 
.word 
-word 
-word 
.-word 
.word 
-word 
-word 
-word 
.-word 
.-word 
-word 
.-word 
.word 
.-word 
-word 
.-word 
.-word 
.word 
-word 
-word 
-word 
.-word 
-word 
.word 
-word 
.word 
.-word 
-word 
.-word 
.word 
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OABh 
185h 
OFFF6h 
93h 
1Fh 


10] 


a 
Eh 


59h 

OFEFOh 
96h 

OFFBFh 
OFF47h 
OFF76h 
OFFOBh 
OFFAFh 


14Bh 


OFF3Bh 
132h 
289h 
8Dh 


13Ch 
OFEF7h 
OFE36h 
80h 
OFFBBh 
OFC8Eh 
10Eh 


37 


Dh 


6FAh 


lh 


OFD89h 
198h 


OF! 


E4Ch 


OF! 


E78h 


OF215h 
479h 
749n 
289h 
OF667h 
304h 
5F8h 
34Fh 


47} 


Bh 


OFF7Eh 


85] 


Bh 


OF837h 
OF77Eh 
OFF80h 
OB9Bh 

OFO3Ah 


OE 


B66h 


OFE28h 
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Example 16. Adaptive Filtering Using LMS Instruction (Continued) 


-word OFADOh 
-word 8C3h 
-word OF5D6h 
.-word 14DCh 
-word OF3A7h 
-word OE542h 
-word 10F2h 
-word 566h 
.-word 26AAh 
-word 15Ah 
-word 2853h 
-word OEE95h 
-word 93Dh 
-word 20Dh 
-word 1230h 


.-word 238Ah 


Example 17. 256-Point Real FFT Initialization 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: rfft.asm 
Version: 1.0 
Status : draft €-) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Simon Lau and Nathan Baltz 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-17-96 / Simon & Nathan original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains core routine: 
rfft 


1.3 Specification/Design Reference (optional) 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne SN 
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Example 17. 256-Point Real FFT Initialization (Continued) 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s rfft.asm 


1.6 Notes and Special Considerations 


VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


-mmregs 
- include "main.inc” 
- include “init_54x.inc” 

; 3.2 External Data 
.ref bit_rev, fft, unpack 
sre power 
.cef sine, cosine 
.ref sine_table,cos_table 


3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 
.def rfft_task 


5. SUBROUTINE CODE 
HeaderBegin 


Sd BEES 


5.2 Functional Description 
The following code implements a Radix-2, DIT, 2N-point Real FFT for the 
TMS320C54x. This main program makes four function calls, each 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 17. 256-Point Real FFT Initialization (Continued) 


corresponds to a different phase of the algorithm. For more details about 
how each phase is implemented, see bit_rev.asm, fft.asm, unpack.asm, and 
power.asm assembly files. 


5.3 Activation 
Activation example: 


CALL rfft 
Reentrancy: No 
Recursive : No 
5.4 Inputs 
NONE 
5.5 Outputs 
NONE 
5.6 Global 
Data structure: AR1 
Data Format: 16-bit pointer 
Modified: No 


program to data 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 
DP | OVM|SXM|C16|FRCT/ASM]ARO]AR1]AR2/}AR3|AR4|AR5/AR6/AR7/A |B |BK|BRC] T|TRN 


yin |U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU_ |NU |NU|NU|NU|NU |NU|NU 


;out]U al 1 |NU 1 U NU |UM |NU |NU |NU |NU |NU_ |NU |NU|NU|NU/UM |NU|NU 
Note : UM —- Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


’ 
, 
La 
 g 
’ 
’ 
if 
Fr 
’ 
if 
’ 
¥ 
’ 
’ 
 f 
’ 
’ 
if 
’ 
’ 
Hy Description: used for moving the twiddle tables from 
tf 
’ 
’ 
ia 
, 
’ 
F 
if 
’ 
’ 
if 
¥ 
’ 
’ 
¥ 
’ 
’ 
’ 
rf 
’ 


Call rate: not applicable for this application 
; HeaderEnd 
° 5.10 Code 
-asg AR1,FFT_TWID_P 
-sect "rfft_prg” 
rfft_task: 
STM #Sine,FFT_TWID_P 
RPT #K_FFT_SIZE-1 7 move FIR coeffs from program 
MVPD #sine_ table, *FFT_TWID_P+ ; to data 
STM #cosine, FFT_TWID_P 
RPT #K_FFT_SIZE-1 7; move FIR coeffs from program 
MVPD #cos_table, *FFT_TWID_P+ ; to data 
CALL bit_rev 
CALL fft 
CALL unpack 
CALLD power 
STM #K_ST1,ST1 ; restore the original contents of 
; ST1 since ASM field has changed 
RET ; return to main program 
.end 
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TEXAS INSTRUMENTS INCORPORATED 


Archives: PVCS 

Filename: bit_rev.asm 

Version: 13:0 

Status draft ( ) 
proposal (X) 
accepted ( ) 

AUTHOR Simon Lau and Nathan Baltz 


Application Specific Products 


12203 SW Freeway, 
Stafford, TX 77477 


MS 701 


{ 


IPR statements description 


Texas Instruments. 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. 


{ 
Change history: 


VERSION 
1.0 


DATE / 
July-17-96 / 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


Functional Description 
This file contains one subroutine: 
bit_rev 

Specification/Design Reference 


Module Test Document Reference 
Not done 


Compilation Information 


AUTHORS 
Simon & Nathan 


Notes and Special Considerations 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne SN 


2. VOCABULARY 


.1 Definition of Special Words, 


2.2 Local Compiler Flags 


Ne Ne Ne Ne Ne Ne Ne 
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Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s bit_rev.asm 


Keywords 


DSP Data Communication System Development / ASP ; 


dd-mm-yy/?acceptor. 


Data Communication System Development 


(can be collected). 


All rights reserved. 


COMMENT 
original created 


(optional) 
called by rfft.asm depending upon the task thru CALA 


(optional) 
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Example 18. Bit Reversal Routine (Continued) 


2.3 Local Constants 


aa 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


-mmregs 
- include "main.inc” 

; 3.2 External Data 
.ref d_input_addr, fft_data 


3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 
4.5 Export Functions 
.def bit_rev 


5. SUBROUTINE COD 
HeaderBegin 


GI 


5.1 bit_rev 


5.2 Functional Description 

This function is called from the main module of the ’C54x Real FFT code. 
It reorders the original 2N-point real input sequence by using 
bit-reversed addressing. This new sequence is stored into the data 
processing buffer of size 2N, where FFT will be performed in-place 
during Phase Two. 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Activation 
Activation example: 
CALL bit_rev 
Reentrancy: No 
Recursive : No 
5.4 Inputs 
NONE 
5.5 Outputs 
NONE 
5.6 Global 
Data structure: ARO 
Data Format: 16-bit index pointer 
Modified: No 
Description: used for bit reversed addressing 
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Example 18. Bit Reversal Routine (Continued) 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data Format: 
Modified: 
Description: 


Data structure: 


Data structure: 


Data structure: 


AR2 

16-bit pointer 

Yes 

pointer to processed data in bit-reversed order 


AR3 

16-bit pointer 

Yes 

pointer to original input data in natural order 


AR7 

16-bit pointer 

Yes 

starting addressing of data processing buffer 


5.7 Special considerations for data structure 


5.8 Entry and Exit conditions 


DP | OVM| SXM|C16|FRCT|ASM|ARO/AR1/AR2 


AR3|AR4/AR5/AR6/AR7/A |B |BK/BRC 


T| TRN 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


in |U 1 1 |NU dl; NU |NU |NU |NU |NU |NU_ |NU |NU |NU_ |NU/NU|NU|NU |NU|NU 
out |U 1 1 |NU 1 NU |UM |NU |UM |UM |NU |NU |NU |UM |NU|NU|NU|UM |NU|NU 
Note UM —- Used & Modified, U - Used, NU - Not Used 
5.9 Execution 
Execution time: ?cycles 
Call rate: not applicable for this application 
; HeaderEnd 
5.10 Code 
-asg AR2,REORDERED_ DATA 
-asg AR3, ORIGINAL _INPUT 
-asg AR7, DATA _PROC_BUF 
-sect "CEEC prg” 
bit_rev: 
SSBX FRCT ; fractional mode is on 
MVDK d_input_addr, ORIGINAL_INPUT ; AR3 -> 1 st original input 
STM #££t_data, DATA_PROC_BUF ; AR7 -> data processing buffer 
MVMM DATA_PROC_BUF’, REORDERED_DATA ; AR2 -> 1st bit-reversed data 
STM #K_FFT_SIZE-1, BRC 
RPTBD bit_rev_end-1 
STM #K_FFT_SIZE, ARO ; ARO = 1/2 size of circ buffer 
MVDD *ORIGINAL_INPUT+, *REORDERED_DATA+ 
MVDD *ORIGINAL_INPUT-, *REORDERED_DATA+ 
MAR *ORIGINAL INPUT+0B 
bit_rev_end 
RET ; return to Real FFT main module 
end 
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Example 19. 256-Point Real FFT Routine 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: fft.asm 
Version: 1.0 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Simon Lau and Nathan Baltz 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
{ 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


i} 
;(C) Copyright 1996. Texas Instruments. All rights reserved. 


{ 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-17-96 / Simon & Nathan original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains one subroutine: 
fee: 


Specification/Design Reference (optional) 
called by rfft.asm depending upon the task thru CALA 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02. (PC) 
Activation: asm500 -s fft.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne SN 
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Example 19. 256-Point Real FFT Routine (Continued) 


2.3 Local Constants 


ha ae 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


-mmregs 
- include "main.inc” 

: 3.2 External Data 
.ref fft_data, d_grps_cnt, d_twid_idx, d_data_idx, sine, cosine 


3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 


.def EEt 
} 
5. SUBROUTINE CODE 
HeaderBegin 
oel.-tft 


5.2 Functional Description 
PHASE TWO (LogN)-Stage Complex FFT 
This function is called from main module of the '’C54x Real FFT code. 
Here we assume that the original 2N-point real input sequence is al 
ready packed into an N-point complex sequence and stored into the 
data processing buffer in bit-reversed order (as done in Phase One). 
Now we perform an in-place, N-point complex FFT on the data proces 
sing buffer, dividing the outputs by 2 at the end of each stage to 
prevent overflow. The resulting N-point complex sequence will be un- 
packed into a 2N-point complex sequencein Phase Three & Four. 


5.3 Activation 
Activation example: 


CALL fft 
Reentrancy: No 
Recursive : No 


5.4 Inputs 
NONE 

5.5 Outputs 
NONE 


5.6 Global 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Data structure: ARO 
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Example 19. 256-Point Real FFT Routine (Continued) 
Data Format: 16-bit index pointer 
Modified: No 
Description: index to twiddle tables 
Data structure: AR1 
Data Format: 16-bit counter 
Modified: No 
Description: group counter 
Data structure: AR2 
Data Format: 16-bit pointer 
Modified: Yes 
Description: pointer to 1st butterfly data PR,PI 
Data structure: AR3 
Data Format: 16-bit pointer 
Modified: Yes 
Description: pointer to 2nd butterfly data QR,QI 
Data structure: AR4 
Data Format: 16-bit pointer 
Modified: Yes 
Description: pointer to cosine value WR 
Data structure: AR5 
Data Format: 16-bit pointer 
Modified: Yes 
Description: pointer to cosine value WI 
Data structure: AR6 
Data Format: 16-bit counter 
Modified: Yes 
Description: butterfly counter 
Data structure: AR7 
Data Format: 16-bit pointer 
Modified: Yes 
Description: start address of data processing buffer 
Special considerations for data structure 
Entry and Exit conditions 
DP | OVM|SXM|C16|]FRCT|]ASM]ARO|AR1/AR2/AR3|}AR4|AR5/AR6/AR7/A |B |BK|BRC| T|]TRN 


in |U at 1 |NU 1. QO |NU |NU |NU 
out |U 1 1 |NU 1 -1 |UM |UM |UM 
Note UM - Used & Modified, U - Used, 


5.9 Execution 


NU |NU |NU |NU |NU |NU|NU|NU|NU |NU|NU 


UM |UM |UM |UM |UM |UM|UM|UM|UM |NU|NU 


NU - Not Used 


Execution time: ?cycles 
Call rate: not applicable for this application 
HeaderEnd 
5.10 Code 
-asg AR1,GROUP_COUNTER 
-asg AR2,PX 
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Example 19. 256-Point Real FFT Routine (Continued) 
-asg AR3,QX 
-asg AR4,WR 
-asg AR5,WI 
-asg AR6, BUTTERFLY COUNTER 
-asg AR7, DATA_PROC_BUF ; for Stages 1 & 2 
-asg AR7, STAGE_COUNTER ; for the remaining stages 
«SECE “PELE prg” 
fft: 
. Stage 1 
STM #K_ZERO_BK, BK ; BK=0 so that *ARn+0% == *ARn+0 
LD #-1,ASM ; outputs div by 2 at each stage 
MVMM DATA_PROC_BUF’, PX ; PX -> PR 
LD *PX,A ; A := PR 
STM #£f£t_data+K_DATA_IDX_1,QX 7; QX -> OR 
STM #K_FFT_SIZE/2-1,BRC 
RPTBD stagelend-1 
STM #K_DATA_IDX_1+1, ARO 
SUB *QX,16,A,B ; B := PR-OR 
ADD *QX,16,A ; A := PRtOR 
STH A, ASM, *PX+ ; PR’ := (PR+OR) /2 
ST B, *OX+ ; OR’ := (PR-OR) /2 
| | LD *PX,A ; A os:= PI 
SUB *QX,16,A,B ; B := PI-QI 
ADD *QX,16,A ; A := PI+QI 
STH A, ASM, *PX+0 ; PI’:= (PI+QI)/2 
ST B, *OX+0% ; QI’:= (PI-QI) /2 
| | LD *PX,A ; A := next PR 
stagelend: 
; Stage 2 
MVMM DATA_PROC_BUF, PX ; PX -> PR 
STM #£f£t_data+K_DATA_IDX_2,QX 7; QX -> QR 
STM #K_FFT_SIZE/4-1,BRC 
LD *PX,A ; A := PR 
RPTBD stage2end-1 
STM #K_DATA_IDX_2+1,ARO 
; lst butterfly 
SUB *QX,16,A,B ; B := PR-OR 
ADD *QX,16,A ; A := PRtOR 
STH A, ASM, *PX+ ; PR’ := (PR+OR) /2 
ST B, *OX+ ; OR’ := (PR-OR) /2 
| | LD *PX,A >; A os:= PI 
SUB *QX,16,A,B ; B := PI-QI 
ADD *QX,16,A ; A := PI+QI 
STH A, ASM, *PX+ ; PI’:= (PI+QI) /2 
STH B, ASM, *QX+ ; QI’:= (PI-QI) /2 
; 2nd butterfly 
MAR *OX+ 
ADD *PX,*OX,A ; A := PR+tQI 
SUB *PX, *OX-,B ; B := PR-QI 
STH A, ASM, *PX+ ; PR’ := (PR+tQI) /2 
SUB *PX, *OX,A ; A := PI-OR 
ST B, *OX ; OR’ := (PR-QI) /2 
| | LD *QOX+,B ; Bors OR 
ST A, *PX ; PI’:= (PI-OR) /2 
| | ADD *PX+0%,A ; A := PI+OR 
ST A, *QX+03% ; QI’ := (PI+OR) /2 
| | LD *PX,A ; A := PR 
stage2end: 
; Stage 3 thru Stage logN-1 
STM #K_TWID_TBL_SIZE, BK ; BK = twiddle table size always 
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Example 19. 256-Point Real FFT Routine (Continued) 


ST #K_TWID_IDX_3,d_twid_idx ; init index of twiddle table 
STM #K_TWID_IDX_3, ARO ; ARO = index of twiddle table 
STM #cosine, WR ; init WR pointer 
STM #Ssine, WI ; init WI pointer 
STM #K_LOGN-2-1, STAGE COUNTER ; init stage counter 
ST #K_FFT_SIZE/8-1,d_grps_cnt ; init group counter 
STM #K_FLY_COUNT_3-1, BUTTERFLY_COUNTER ; init butterfly counter 
ST #K_DATA_IDX_3,d_data_idx ; init index for input data 
stage: 
STM #fft_data,PX ; PX -> PR 
LD d_data_idx, A 
ADD *(PX),A 
STLM A,QX 7 QX -> OR 
MVDK d_grps_cnt, GROUP_COUNTER ; AR1 contains group counter 
group: 
MVMD BUTTERFLY _COUNTER, BRC ; # of butterflies in each grp 
RPTBD butterflyend-1 
LD *WR,T ; T := WR 
MPY *QX+,A ; A := OQR*WR || QX->QI 
MACR *WI+0%,*QX-,A ; A := QR*WRtQI*WI 
; || QX->OR 
ADD *PX,16,A,B ; B := (QR*WR+QI*WI)+PR 
ST B, *PX ; PR’ :=((QR*WR+QI*WI)+PR) /2 
||SUB *PX+,B ; B := PR-(QR*WR+QI*WI) 
; || PX->PI 
ST B, *QX ; QR’ := (PR-(QR*WR+QI*WI))/2 
| |MPY *QX+,A ; A := OQR*WI [T=WI] 
; || Qx->oI 
MASR *QX,*WR+03,A ; A := QR*WI-QI*WR 
ADD *PX,16,A,B ; B := (QR*WI-QI*WR) +PI 
ST B, *QX+ 7 QI’ :=((QR*WI-QI*WR) +PI) /2 
; || QxX->oOR 
| |SUB *PX,B ; B := PI-(QR*WI-QI*WR) 
LD *WR,T Hoel := WR 
ST B, *PX+ ; PI’:= (PI-(QR*WI-QI*WR) ) /2 
; || PX->PR 
| |MPY *QX+,A ; A := QR*WR || QX->QI 
butterflyend: 
; Update pointers for next group 
PSHM ARO ; preserve ARO 
MVDK d_data_idx, ARO 
MAR *PX+0 ; increment PX for next group 
MAR *OX+0 ; increment QX for next group 
BANZD group, *GROUP_COUNTER- 
POPM ARO ; restore ARO 
MAR *OX- 
; Update counters and indices for next stage 
LD d_data_idx,A 
SUB #1,A,B ; B= A-1 
STLM B, BUTTERFLY_COUNTER ; BUTTERFLY_COUNTER = #flies-1 
STL A,1,d_data_idx ; double the index of data 
LD d_grps_cnt,A 
STL A, ASM, d_grps_cnt ; 1/2 the offset to next group 
LD d_twid_idx,A 
STL A, ASM, d_twid_idx ; 1/2 the index of twiddle table 
BANZ D stage, *STAGE_COUNTER- 
MVDK d_twid_idx, ARO ; ARO = index of twiddle table 
fft_end: 
RET ; return to Real FFT main module 
.end 
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Example 20. Unpack 256-Point Real FFT Output 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: unpack.asm 
Version: 1.0 
Status: : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Simon Lau and Nathan Baltz 


Application Specific Products 

Data Communication System Development 

12203 SW Freeway, MS 701 

Stafford, TX 77477 
IPR statements description (can be collected). 
(C) Copyright 1996. Texas Instruments. All rights reserved. 
Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-17-96 / Simon & Nathan original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains one subroutine: 
unpack 


1.3 Specification/Design Reference (optional) 
called by rfft.asm depending upon the task thru CALA 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s unpack.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 
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Example 20. Unpack 256-Point Real FFT Output (Continued) 


2.3 Local Constants 


ph pe 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


-mmregs 
-include "main.inc” 

7 3.2 External Data 
.ref fft_data,sine, cosine 


3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


, 
, 
, 
, 
, 
vr 
, 
; 4.2 Global Static Data 
, 
, 
, 
al 
, 
| 


4.3 Dynamic Data 


4.4 Temporary Data 
4.5 Export Functions 
.def unpack 


5. SUBROUTINE COD 
HeaderBegin 


GI 


5.1 unpack 
5.2 Functional Description 


PHASE THREE & FOUR Unpacking to 2N Outputs 

This function is called from the main module of the ’C54x Real FFT 
code. It first computes four intermediate sequences (RP,RM, IP, IM) 
from the resulting complex sequence at the end of the previous phase. 
Next, it uses the four intermediate sequences to form the FFT of the 
original 2N-point real input. Again, the outputs are divided by 2 to 
prevent overflow 


5.3 Activation 
Activation example: 
CALL unpack 


Reentrancy: No 
Recursive : No 


5.4 Inputs 
NONE 

5.5 Outputs 
NONE 


5.6 Global 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 20. 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


~e 


Data structure: 
Data Format: 
Modified: 
Description: 


~e 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Data structure: 
Data Format: 
Modified: 
Description: 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Data structure: 
Data Format: 
Modified: 
Description: 


Ne Ne Ne Ne Ne Ne Ne 
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5.6.1 Phase Three Global 


5.6.2 Phase Four Global 


INSTRUMENTS 
Unpack 256-Point Real FFT Output (Continued) 
ARO 
16-bit index pointer 
No 
index to twiddle tables 
AR2 
16-bit pointer 
Yes 
pointer to R[k], I[k], RP[k], IP[k] 
AR3 
16-bit pointer 
Yes 
pointer to R[N-k], I[N-k], RP[N-k], IP[N-k] 
AR6 
16-bit pointer 
Yes 
pointer to RM[k], IM[k] 
AR7 
16-bit pointer 
Yes 
pointer to RM[n-k], IM[n-k] 
ARO 
16-bit index pointer 
No 
index to twiddle tables 
AR2 
16-bit counter 
No 
pointer to RP[k], IP[k], AR[k], AI[k], AR[0] 
AR3 
16-bit pointer 
Yes 
pointer to RM[k], IM[k], AR[2N-k], AI[2N-k] 
AR4 
16-bit pointer 
Yes 
pointer to cos(k*pi/N), ATI[0] 
AR5 
16-bit pointer 
Yes 
pointer to sin(k*pi/N), AR[N], AI[N] 


5.7 Special considerations for data structure 
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Example 20. Unpack 256-Point Real FFT Output (Continued) 


5.8 Entry and Exit conditions 
5.8.1 Phase Three Entry and Exit Conditions 
DP | OVM|SXM|C16|FRCT/]ASM]ARO]|]AR1/]AR2/}AR3|AR4|AR5/AR6/AR7/A |B |BK|BRC] T|]TRN 
yin |2 il 1 0 1 0 |NU |NU |NU |NU |NU |NU |NU |NU |NU/]NU/O |NU |NU/NU 
,out|2 il alt 0 1 -1 |UM |NU |UM |UM |NU |NU |UM |UM |UM/UM|UM/UM |NU|NU 
Note : UM - Used & Modified, U - Used, NU - Not Used 


5.8.2 Phase Four Entry and Exit Conditions 


;in |U at 1 0 1. -1 |NU |NU |NU |NU |NU |NU |NU |NU |NU|NU|NU|NU |NU|]NU 
;out]U 1 al 0 1 -1 |UM |NU |UM |UM |UM |UM |NU |NU |UM|UM|UM|UM |NU|NU 
Note : UM - Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


7 
7 
14 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
’ 
La 
; DP | OVM| SXM|C16|FRCT|ASM]ARO|]AR1/AR2/AR3|/AR4/AR5|AR6|AR7|A |B |BK|BRC| T|TRN 
7 
’ 
’ 
v 
’ 
’ 
’ 
’ 
’ 
v 
’ 
’ 
’ 
4 


Call rate: not applicable for this application 
HeaderEnd 
5.10 Code 
-sect "FETE _prg” 
unpack: 
; Compute intermediate values RP, RM, IP, IM 

-asg AR2,XP_k 

-asg AR3, XP_Nminusk 

-asg AR6,XM_k 

-asg AR7, XM_Nminusk 

STM #£f£t_datat+2, XP_k ; AR2 -> R[k] (temp RP[k]) 

STM #f£fft_datat+2*K_FFT_SIZE-2,XP_Nminusk ; AR3 -> R[N-k] (temp 
RP [N-k] ) 

STM #f£ft_datat+2*K_FFT_SIZE+3,XM_Nminusk ; AR7 -—> temp RM[N-k] 

STM #£f£t_datat4*K_FFT_SIZE-1, XM_k ; AR6 -> temp RM[k] 

STM #-2+K_FFT_SIZE/2,BRC 

RPTBD phase3end-1 

STM #3, ARO 

ADD *XP_k, *XP_Nminusk,A ; A := R[k]+R[N-k] = 
2*RP [k] 

SUB *XP_k, *XP_Nminusk,B ; B := R[k]-R[N-k] 
2*RM[k] 

STH A, ASM, *XP_k+ ; store RP[k] at AR[k] 

STH A,ASM, *XP_Nminusk+ ; store RP[N-k]=RP[k] at 
AR[N-k] 

STH B, ASM, *XM_k- ; store RM[k] at AI [2N-k] 

NEG B - Bes R[N-k]-R[k] 
2*RM[N-k] 

STH B, ASM, *XM_Nminusk- ; store RM[N-k] at AI[N+k] 

ADD *XP_k, *XP_Nminusk,A ; A := I[k]+I[N-k] = 
2*IP[k] 

SUB *XP_k, *XP_Nminusk,B ; B := I[k]-I[N-k] 
2*IM[k] 
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STH 
STH 


STH 
NEG 


STH 
phase3end: 
ST 
ST 
; Compute 
-asg 
-asg 
-asg 
STM 


STM 


STM 
ADD 
SUB 
STH 
ST 
MVDD 
STH 
7 Compute 
-asg 
-asg 
-asg 
STM 


STM 
STM 
STM 
RPTBD 
STM 
LD 
MACR 


MASR 


LD 


MASR 


MASR 


STH 
STH 
NEG 
STH 


STH 
phase4end: 


RET 
.end 
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Example 20. Unpack 256-Point Real FFT Output (Continued) 


A, ASM, *XP_k+ 
A, ASM, *XP_Nminusk-0O 


B, ASM, *XM_k- 
B 


B, ASM, *XM_Nminusk+0 


#0, *XM_k- 
#0, *XM_k 

AR[0],AI[0], AR[N], AI[N] 
AR2,AX_k 
AR4,IP_0O 
AR5,AX_N 
#£f£t_data, AX_k 


#f£ft_datat+1, IP_0O 


#£f£t_data+2*K_FFT_SIZE+1,AX_N 
*AX_k,*IP_O,A 

*AX k,*IP_0,B 

A, ASM, *AX_k+ 

#0, *AX_k 

*AX k+, *AX_N- 

B, ASM, *AX_N 


final output values AR[k], AI[k] 


AR3,AX_2Nminusk 
AR4,COS 
AR5, SIN 


#£ft_datat+t4*K_FFT_SIZE-1,AX_2Nminusk 


Ne Ne Ne Ne 


store IP[k] at AI[k] 

store IP[N-k]=IP[k] at 
AI [N-k] 

store IM[k] at AR[2N-k] 

B := I[N-k]-I[k] = 
2*IM[N-k] 

store IM[N-k] at AR[N+k] 


RM[N/2]=0 
IM[N/2]=0 


AR2 -> AR[O] (temp 
RP[0]) 
AR4 -> AI[0] (temp 
IP[0]) 
AR5 -> AI[N] 
A := RP[0]+IP[0] 
B := RP[0O]-IP[0O] 
AR[O] = (RP[O]+IP[0])/2 
; AI[0O] = 0 
; AI[N] = 0 
; AR[N] = (RP[O]-IP[0])/2 


; AR3 -> AI[2N-1] 
(temp RM[1]) 


#cosine+K_TWID_TBL_SIZE/K_FFT_SIZE,COS ; AR4 -> cos(k*pi/N) 


#sine+K_TWID_TBL_SIZE/K_FFT_SIZE, SIN 


#K_FFT_SIZE-2,BRC 
phase4end-1 


#K_TWID_TBL_SIZE/K_FFT_SIZE, ARO 


*AX k+,16,A 
*COS, *AX_k,A 


*SIN, *AX_2Nminusk-,A 


*AX 2Nminusk+,16,B 


*SIN+0%, *AX_k-,B 


*COS+0%, *AX_2Nminusk,B 


A, ASM, *AX_k+ 
B, ASM, *AX_k+ 
B 
B, ASM, *AX_2Nminusk-— 


A, ASM, *AX_2Nminusk-— 
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; AR5 -—> sin(k*pi/N) 


; index of twiddle 


tables 

; A := RP[k] || 
AR2->IP[k] 

; A :=At+cos (k*pi/N) 

*IP[k] 

; A := A-sin(k*pi/N) 
*RM[k] 

; || AR3->IM[k] 

; B := IM[(k] || 
AR3->RM[k] 

; B := B-sin(k*pi/N) 
*IP[k] 

; || AR2->RP[k] 

; B := B-cos(k*pi/N) 
*RM[k] 


AR[k] = A/2 
AI[k] = B/2 


Ne Ne Ne Ne 


B. 2] =B 
AI[2N-k] = -AI[k] 
= B/2 
; AR[2N-k] = AR 
[k] = A/2 


; returntoRealFFTmain module 
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Example 21. Compute the Power Spectrum of the Complex Output 
of the 256-Point Real FFT 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: power.asm 
Version: 1 en 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Simon Lau and Nathan Baltz 


Application Specific Products 

Data Communication System Development 
12203 SW Freeway, MS 701 

Stafford, TX 77477 


“a 


IPR statements description (can be collected). 


(C) Copyright 1996. Texas Instruments. All rights reserved. 


Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-17-96 / Simon & Nathan original created 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 
This file contains one subroutine: 
power 


1.3 Specification/Design Reference (optional) 
called by rfft.asm depending upon the task thru CALA 


1.4 Module Test Document Reference 
Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s power.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, Keywords (optional) 


2.2 Local Compiler Flags 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 21. Compute the Power Spectrum of the Complex Output 
of the 256-Point Real FFT (Continued) 


2.3 Local Constants 


etn: Nepe 


3. EXTERNAL RESOURCES 


Ne Ne Ne Ne Ne Ne Ne 


3.1 Include Files 


-mmregs 
- include "main.inc” 

; 3.2 External Data 
.ref fft_data, d_output_addr 


3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


4.5 Export Functions 
-def power 


5. SUBROUTINE COD 
HeaderBegin 


Gl 


5.1 power 


5.2 Functional Description 
PHASE FIVE Power Spectrum 
This function is called from the main module of the ’C54x Real FFT 
code. It computes the power spectrum of the Real FFT output. 


5.3 Activation 
Activation example: 


CALL power 
Reentrancy: No 
Recursive : No 
5.4 Inputs 
NONE 
5.5 Outputs 
NONE 
5.6 Global 
Data structure: AR2 
Data Format: 16-bit pointer 
Modified: Yes 
Description: pointer to AR[k], AI[k] 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 21. Compute the Power Spectrum of the Complex Output 
of the 256-Point Real FFT (Continued) 


Data structure: AR3 


Data Format: 16-bit pointer 
Modified: Yes 
Description: pointer to output buffer 


5.7 Special considerations for data structure 

5.8 Rntey and Exit conditions 

DP |OVM|SXM|C16]FRCT|ASM|ARO|AR1]AR2]AR3|AR4/AR5|AR6/AR7|/A |B |BK|BRC| T|TRN 
ain |U 1 1 |NU 1 NU |NU |NU |NU |NU |NU |NU |NU_ |NU_ |NU|NU/NU|NU |NU|NU 
out |U il 1 |NU 1 NU |NU |NU |UM |UM |NU |NU |NU |NU |UM|NU/|NU|UM |NU|NU 
Note : UM —- Used & Modified, U - Used, NU - Not Used 


5.9 Execution 
Execution time: ?cycles 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Call rate: not applicable for this application 
HeaderEnd 
5.10 Code 
-asg AR2, AX 
-asg AR3, OUTPUT_BUF 
-sect "“pwr_prog” power: 
MVDK d_output_addr, OUTPUT_BUF ; AR3 points to output buffer 
STM #K_FFT_SIZE*2-1,BRC 
RPTBD power_end-1 
STM #£f£t_data, AX ; AR2 points to AR[O] 
SQUR *AX+,A ; A := AR*%2 
SQURA *AX+,A ; A := AR*2 + AI*2 
STH A, *OUTPUT_BUF+ 
power_end: 
RET ; return to main program 
.end 


Example 22. Data Transfer from FIFO 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: fifo.asm 
Version: 10 
Status : draft «) 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 

Data Communication System Development 
12203 SW Freeway, MS 701 

Stafford, TX 77477 


“a 


IPR statements description (can be collected). 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


(C) Copyright 1996. Texas Instruments. All rights reserved. 
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Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Ne Ne Ne Ne Ne Ne Ne 


Ne Ne Ne 
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Example 22. Data Transfer from FIFO (Continued) 


Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-25-96 / P.Mallela original created 
ABSTRACT 


-1 Function Type 


a.Core Routine 
b.Subroutine 


Functional Description 

This file contains one subroutines: 

fifo_host_transfer 

Specification/Design Reference (optional) 

called by main.asm depending upon if K_HOST_FLAG is set 


Module Test Document Reference 
Not done 


Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1.02 (PC) 
Activation: asm500 -s fifo.asm 


Notes and Special Considerations 


VOCABULARY 


-1 Definition of Special Words, Keywords (optional) 


-2 Local Compiler Flags 


-3 Local Constants 


EXTERNAL RESOURCES 


Include Files 


-mmregs 
- include "target.inc” 
External Data 

.ref d_command_reg 
.ref d_fifo_count 
.ref d_command_value 
srer d_fifo_ptr 

.ref d_output_addr 


Import Functions 
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Example 22. Data Transfer from FIFO (Continued) 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


4.5 Export Functions 
.def fifo_host_transfer 


5. SUBROUTINE COD 
HeaderBegin 


Gl 


5.1 fifo_host_transfer 


5.2 Functional Description 

This routine transfers a FIFO(64) of data to host thru CH B. 

In the process, after transferring data from DSP to FIFO sends a com-— 
mand to host thru CH A.The host acknowledges and sends a command to 
target (DSP) thru CH A. The host transfer can be disabled by setting 
the K_HOST_FLAG =0 


5.3 Activation 
Activation example: 


CALL fifo_host_transfer 

Reentrancy: No 

Recursive : No 

Inputs 
Data structure: d_output_addr 
Data Format: 16-bit variable 
Modified: NO 

Description: holds the starting addr of either PING/PONG addr. 

Data structure: d_fifo_count 
Data Format: 16-bit var 
Modified: Yes 
Description: counter for # of transfers 


Data structure: d_fifo_ptr 

Data Format: 16-bit variable 

Modified: Yes 

Description: holds the output bffr addr. and incremented by 
32 for every transfer 


5.5 Outputs 


Data structure: AR7 


Data Format: 16-bit output buffer pointer 
Modified: Yes 
Description: either point to PING/PONG buffer 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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in |U 1 
out |U 1 
Note 


5.6 Global 


qd 
ul 


UM —- Used & Modified, 


5.9 Execution 


Wy TEXAS 
INSTRUMENTS 


Example 22. Data Transfer from FIFO (Continued) 


1 
uf 


Data structure: 
Data Format: 
Modified: Yes 
Description: 
Data structure: 
Data Format: 
Modified: Yes 
Description: 


5.8 Entry and Exit conditions 


d_command_reg 
16-bit variable 


command from host is read thru CH A 
d_command_value 
16-bit variable 


holds the command value 


5.7 Special considerations for data structure 


DP | OVM| SXM|C16|FRCT|]ASM]ARO}]AR1/AR2/AR3/AR4]AR5/AR6|AR7|A |B |BK|BRC| T|TRN 


NU |NU |NU |NU |NU |NU |NU |NU |U NU|NU|NU|NU |NU|NU 
NU |NU |NU |NU |NU |NU |NU |NU |U UM|NU|NU|NU |NU|NU 


U - Used, 


NU - Not Used 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


Execution time: ?cycles 
Call rate: not applicable for this application 
HeaderEnd 
5.10 Code 

fifo_host_transfer: 

LD #FIFO_DP,DP 

wank K_HOST_FLAG =1 

PORTR K_TRGCR_ADDR, d_command_reg ; while (port14 & BXST) 

BITF d_command_reg, K_BXST 

BC fifo_discard, TC ; FIFO discard 

MVDK d_output_addr, OUTBUF_P ; load PING/PONG bffr address 
RPT #K_FIFO_SIZE-1 ; write first set of 64 data 

; to FIFO 

PORTW *OUTBUF_P+,K_CHB ; Fill FIFO 

ST #K_FIFO_FULL, d_command_value 

PORTW d_command_value, K_CHA ; write command to comnd reg A 
ST #1,d_fifo_count ; start counting for tranfers 
MVKD OUTBUF_P,d_fifo_ptr ; save the fifo_ptr 

fifo_discard 

-endif 

RET 

-end 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* This file includes the TCR register configuration of EVM 
KEKKKKKKKKKK KK KKK KKK KKK KKK KK KK KKK KK KK KKK KKK KKK KK KKK KKK KK KKKKKKKKKKKKKKKK 


K_ATC_RST 
K_USR_BOT 


K_RESRV 
K_USR_BIN 
K_RCV_BRST 


K_XMT_BXST 


-set 
-set 


-set 
-set 
-set 


-set 


Ob << 15 
000b << 12 


0000b << 8 
O00b << 6 
O0Ob << 4 


Lib << 2 
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if AICRST=0, aic is reset 
User discrete output bits 
Opcly 2. 

Reserved bits 

User discrete input bits 0,1 
Channel B receive status regs 
buffer half or more 

Ch B trasnmit status register 
buffer half or more 
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Example 22. Data Transfer from FIFO (Continued) 


K_RCV_ARST -set Ob << 1 ; Ch A receive register 

K_XMT_AXST -set Ob << 1 ; Ch A transmit register 
K_TCR_HIGH .set K_AIC_RST|K_USR_BOT|K_RESRV 

K_TCR_LOW .set K_USR_BIN|K_RCV_BRST|K_XMT_BXST|K_RCV_ARST |K_XMT_AXST 
K_TCR -set K_TCR_HIGH|K_TCR_LOW 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* this includes I/O address of CH_A, CH_B and different commands that’s been 


* passed between host and the target 
KEKKKKKKKKKKKKKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KK KKK KK KK KKKKKKKKKKKKKKKK 


K_O -set Oh ; constant O 

K_FIFO_FULL -set OxFF ; Full FIFO command written by 
7 target 

K_FIFO_EMPTY -set OxEE ; Empty FIFO command 


; written by host 
K_AXST_CLEAR -set OxAE ; Clear AXST empty command 
written by the target 


, 
i 
K_HANDSHAKE__CMD -set OxAB ; handshake CMD written by host 
K_CHB -set 12h ; Use Channel B as I/O interface 
; to 54x EVM for sending data 
K_CHA -set 10h ; Use Channel A as I/O interface 
; to 54x EVM for send command 
; to host 
K_TRGCR_ADDR .set 14h ; Target status control register 
I/O address location 
K_AXST -set lh ; Oh 
K_ARST -set 2h ; used to check the control bits 
K_BXST -set 3h ; check if K_FIFO_SIZE 
.set 64 ; its a 64 FIFO 
K_FRAME_ SIZE -set 256 ; Frame size 
K_HOST_FLAG -set al. ; if 0, then host interface 
ig 


is disabled 


Example 23. Interrupt 1 Service Routine 


TEXAS INSTRUMENTS INCORPORATED 
DSP Data Communication System Development / ASP 


Archives: PVCS 
Filename: hst_intl.asm 
Version: 1.0 
Status : draft () 
proposal (X) 
accepted ( ) dd-mm-yy/?acceptor. 
AUTHOR Padma P. Mallela 


Application Specific Products 
Data Communication System Development 
12203 SW Freeway, MS 701 
Stafford, TX 77477 
IPR statements description (can be collected). 


(C) Copyright 1996. Texas Instruments. All rights reserved. 


Change history: 


VERSION DATE / AUTHORS COMMENT 
1.0 July-25-96 / P.Mallela original created 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 
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Example 23. Interrupt 1 Service Routine (Continued) 


1. ABSTRACT 


1.1 Function Type 
a.Core Routine 
b.Subroutine 


1.2 Functional Description 


This file contains interrput service routine INTI1: 


1) host_command_int1l 


1.3 Specification/Design Reference (optional) 
INT1 is serviced whenever host writes to CHA 


1.4 Module Test Document Reference 


Not done 


1.5 Compilation Information 


Compiler: TMS320C54X ASSEMBLER 
Version: 1202 (PC) 
Activation: asm500 -s hst_intl.asm 


1.6 Notes and Special Considerations 


2. VOCABULARY 


2.1 Definition of Special Words, 


2.2 Local Compiler Flags 


2.3 Local Constants 


3. EXTERNAL RESOURCES 


3.1 Include Files 


-mmregs 
- include "target.inc” 
3.2 External Data 
.ref FIFO_DP 
.ref d_command_reg 
.ref d_fifo_count 
.ref FIFO_DP 
.ref d_command_value 
ter d_fifo_ptr 
.ref d_output_addr 


3.3 Import Functions 


4. INTERNAL RESOURCES 


4.1 Local Static Data 


4.2 Global Static Data 
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Example 23. Interrupt 1 Service Routine (Continued) 


4.3 Dynamic Data 


4.4 Temporary Data 


Ne Ne Ne Ne Ne 


4.5 Export Functions 
.def host_command_int1 


5. SUBROUTINE CODE 
HeaderBegin 


5.1 host_command_intl 


5.2 Functional Description 
The host generates INT1 DSP whenever it writes to CH A. In INTL 
service routine, the command from host is read whether the FIFO 


Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne Ne 


has been empty. Writes another 32 data from target to FIFO. 

Sends a command to host. The host acknowledges the command and read 
the 32 data from the FIFO and sends a command to the target for 
another set of 32 data. This process continues for 6 times till all 
256 processed samples are transferred to host. Processing INT1 is 


done background, 


i.e., INT1 is globally enabled. 


Activation 


Activation example: 


PSHM STO 
PSHM STl 


Reentrancy: 
Recursive 


Inputs 


Data Format: 


Data structure: 


BD host_command_int1l 


d_fifo_count 
16-bit var 


Modified: Yes 

Description: counter for # of transfers 

Data structure: d_fifo_ptr 

Data Format: 16-bit variable 

Modified: Yes 

Description: holds the output bffr addr. and incremented by 
32 for every transfer 

Outputs 

Data structure: AR7 

Data Format: 16-bit output buffer pointer 

Modified: Yes 

Description: either point to PING/PONG buffer 

Global 


Data Format: 
Modified: 
Description: 


Data structure: 


d_command_reg 

16-bit variable 

Yes 

command from host is read thru CH A 
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Data stru 
Data Form 
Modified: 
Descripti 
5.7 Special c 


5.8 Entry and 


DP |OVM| SXM|C1 


,;out}]U al 1 |NU 
Note : UM - 


5.9 Execution 


Wy TEXAS 
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Example 23. Interrupt 1 Service Routine (Continued) 


cture: d_command_value 
at: 16-bit variable 
Yes 
on: holds the command value 


onsiderations for data structure 


Exit conditions 


6|FRCT|ASM|ARO|AR1|AR2|AR3|AR4|/AR5|/AR6/AR7/A |B |BK/BRC|] T|TRN 


1 NU |NU |NU |NU |NU |NU |NU |U U NU|NU|NU|NU |NU|NU 


1 NU |NU |NU |NU |NU |NU |NU |NU |U UM|NU|NU|NU |NU|NU 


Used & Modified, U - Used, NU - Not Used 


’ 
ir 
’ 
’ 
’ 
Ld 
La 
4 
’ 
’ 
14 
jin |U 1 1 |NU 
’ 
’ 
tf 
A 
rf 
ie 
’ 
’ 
’ 
’ 
’ 
’ 


Execution time: ?cycles 
Call rate: not applicable for this application 
HeaderEnd 
5.10 Code 
-asg AR7, OUTBUF_P ; output buffer pointer 
-asg AR7,SV_RSTRE_AR7 
-sect TFiLfO. fa” 
host_command_intl1: 
PSHM AL 
PSHM AH 
PSHM AG 
PSHM SV_RSTRE_AR7 ; AR7 is used as a poiner for 
; output buffer 
LD #FIFO_DP,DP ; restore the DP 
PORTR K_CHA, d_command_value ; read command from host 
wait_host_receive_data 
PORTR K_TRGCR_ADDR,d_command_reg ; while (port14 & AXST) 
BITF d_command_reg, K_ARST 7 check FIFO empty 
BC wait_host_receive_data,TC ; branch occurs 
LD #K_FIFO_EMPTY,A ; indicate of FIFO empty 
SUB d_command_value,A 
bad_command 
BC bad_command, ANEQ ; read the command send by host 
LD # (K_FRAME_SIZE/ (K_FIFO_SIZE/2))-1,A 
SUB d_fifo_count,A ; check for complete transfer of 
; 256 samples 
BC start_remain_fifo_transfer, AGT 
BD transfer_over 
ST #0,d_fifo_count ; reset the fifo count 
; start_remain_fifo_transfer 
MVDK d_fifo_ptr,OUTBUF_P ; load PING/PONG bffr address 
RPT # (K_FIFO_SIZE/2)-1 ; write 32 data to FIFO 
PORTW *OUTBUF_P+,K_CHB ; Fill FIFO half 
ST #K_FIFO_FULL, d_command_value 
PORTW d_command_value, K_CHA ; write command to cmmnd reg A 
; for FIFO half 
ADDM #1,d_fifo_count 
MVKD OUTBUF_P,d_fifo_ptr ; save the fifo_ptr 
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Example 23. Interrupt 1 Service Routine (Continued) 
transfer_over: 


POPM SV_RSTRE_AR7 ; restore AR7 
POPM AG 

POPM AH 

POPM AL 

POPM ST1 

POPM STO 

RETE 

.end 


Example 24. Function Calls on Host Side 


Host Action 
[KKK KKK KR KKK KKK KK KK KK KK OK OK OK KK KK KK / 
/* FILE NAME: HOST.C */ 
[a C54x EVM/HOST COMMUNICATION FUNCTIONS -- HOST SIDE */ 


[KKK KR KKK KK KK KK KK OK KK KK KR OK OK OK KK OK KKK RK / 
#include "graphic2.c” 


#include “host.h” /* flag names, constants af 
/* 
This function initializes the data buffer and reads the FIFO so that FIFO 
is empty when the real data transfers start 
* / 
void initialize_slave (void) 
{ 
int 4; 
for (j=0;j < 64; Jjtt) 
dataa[j] = inport(BDAT_REG) ; /* read data from data reg. * / 
for (j=0;3 <256; j++) 
dataa[j] = 0; 
outport (CONT_REG, inport(CONT_REG) & Oxf7ff); 
} 
/* 


The target sends a command to the host after collecting 32 word data from DSP 
memory to FIFO. The host checks if the command has been received 


/ 
int receive_command_FIFO_FULL (void) 
/* RECEIVE COMMAND FROM EVM * / 

{ 
while(! (inport (CONT_REG) & ARST) ) ; /* wait for evm to send command*/ 
reply = inport (ADAT_REG) ; /* read command into reply*/ 
while ((reply & OxFF) !=0xFF) ; return(reply) 

; /* return command for process’ g*/ 

pe */ 

Vass This function sends a command to target for a new set of data from FIFO*/ 


void send_command_new_FIFO(command unsigned int command; 
{ 
command = OxEE; 
outport (ADAT_REG, command) ; 
while (inport (CONT_REG) & AXST); 


/* 


This initiates the handshake between the target and host. The host writes 

a command to target which sets the AXST flag to 1. The INT1 is generated 
whenever host writes to CH A. On the target side, INT1 is polled and reads 
the CH A.This clears ARST on target side. A command is written to Ch A on 
target after emptying the FIFO that sets AXSt =1. Later sets XF to go low. 
On host XF is polled and then reads CH A that clears ARST to 0 and AXST to 0 
on the target side 
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Example 24. Function Calls on Host Side (Continued) 


oo 


int receive_clear_AXST (void) 


/* RECEIVE COMMAND FROM EVM 


command = OxAB; 

outport (ADAT_REG, command) ; 

while (inport (CONT_REG) & AXST); 
while ((inport (CONT_REG) & XF)); 
while(! (inport (CONT_REG) & ARST)); 
reply = inport (ADAT_REG) ; 

while ((reply & OxAE) !=0xAE); 
return (reply); 


} 


ef 


/* write command to evm */ 


/* wait for evm to send command*/ 
/* read command into reply 


a7 


/* return command for process’g*/ 


/* 


*/ 


Example 25. Main Function Call on Host Side 


[KKK KR KKK KKK KKK KK KR KK KK OK KK KR OK OR KK KK KK KK / 


/* FILE NAME: MASTER.C * / 
/* C54x EVM/HOST COMMUNICATION FUNCTIONS -- HOST SIDE */ 
[RR KKK KKK KKK KK KK KK KK KR KK KR OK OK KK OK OK KK KR KK / 

#define Fl 15104 

#define F2 15360 

#define F3 15616 

#define DATA_FRAME 256 

#include <bios.h> 

#include "“view2.c” 


int get_kbhit (void); 


extern void send_command_new_FIFO(unsigned int); 


void main(void) 


int count=0,n,fifo_size; 
int main_done =0; 

int done = 0; 

int hit; 

initialize _slave(); 


/* a command is written to CH A to initiate handshake */ 
command_AXST = receive_clear_AXST() 
: while (!main_done) 
{ 
done =0; 
init_graphics () 
; while (!done) 
{ 
count =0; 
if (kbhit ()) 
{ 
hit = get_kbhit(); 
setviewport (120, 433,290,445,0); 
clearviewport (); 
switch (hit) 
{ 
case (F1): amplitude = amplitude * 2 ; outtextxy(1,1,”Amplitude 
; decreased”) 
; break; 
// case (F2): if (amplitude>=2) amplitude = amplitude / 2 
; outtextxy (1,1, ”Amplitude 
; increased”) 
; break; 
case (F2): done =1 7 closegraph () 
; break; 
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Example 25. Main Function Call on Host Side (Continued) 


case (F3): done =1 ;main_done=1 
;closegraph () 
; break; 


command_FIFO = receive_command_FIFO_FULL(); 
for (fifo_size=0; fifo_size < 64; fifo_sizet+t) 
dataa[fifo_sizet+count] = inport (BDAT_REG) ; 
send_command_new_FIFO (command) ; 

for (count=64; count< 256; count++) 


command_FIFO = receive_command_FIFO_FULL(); /* command from target*/ 
for (fifo_size=0; fifo_size < 32; fifo_sizet+tt) 
dataa[fifo_sizetcount] = inport (BDAT_REG) ; /* read 32 word fifo*/ 
count = count+31; 
send_command_new_FIFO (command) ; /* send command to target*/ 
} 
screen(); 
} 
} 
} 
closegraph(); 


int get_kbhit (void) 


unsigned int key = bioskey(0); 
fflush (stdin); 
return (key); 


[KR KKK KKK KKK KKK KK KK KK KK OK KR OK OK KKK KK KK KK / 


/* FILE NAME: HOST.H C54x */ 
f* HOST SIDE FLAGS, CONSTANTS, COMMAND NUMBERS, AND GLOBAL VARIABLES wee 
* * 
[ei eee indo iene eae en es 
/* The numbers I’ve picked for the file I/O constants, command numbers, and */ 
/* basic control constants are not important. These numbers could really *f 
/* be anything, as long as two of them are not the same. Please notice the ay 
/* pattern I used for file commands. Masks and pointers CANNOT be changed. a 

#include <stdio.h> 

/* FILE I/O CONSTANTS AND COMMAND yy, 
#define MAX_FRAME 256 /* size of data frame to be passed */ 

/* BASIC CONTROL CONSTANTS * / 
#define STOP 99 

#define NO 98 

#define YES 97 

#define READY 96 

#define CLEAR 95 

#define ACKNOWLEDGE 0 

/* POINTERS TO DATA, COMMAND, AND CONTROL REGISTERS ef 
unsigned int ADAT_REG = (unsigned int ) (0x240 + 0x800); 

unsigned int BDAT_REG = (unsigned int ) (0x240 + 0x804); 

unsigned int CONT_REG = (unsigned int ) (0x240 + 0x808); 
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/*------------ MASKS FOR READING MESSAGE FLAGS OF CONTROL REGISTER ----------- i 

unsigned int XF = (unsigned int ) 0x0020; 

unsigned int ARST (unsigned int ) 0x0002; 

unsigned int AXST = (unsigned int ) 0x0001; 

unsigned int BRST_MASK = (unsigned int ) 0x0200; 

unsigned int BXST_MASK = (unsigned int ) 0x0008; 

[* GLOBAL VARIABLES USED BY EVM.C AND MASTER.C * / 

FILE*file[20]; /* stores ptrs to files in files.dat*/ 

int reply; /* integer for whatever * / 

int reply1[128]; 

int data[256]; 

int index; 

unsigned int command; 

unsigned int command1; 

unsigned int command_new_data; 

unsigned int command_FIFO; 

unsigned int command_AXST; 

unsigned int command_HANDSHAKE; 


int amplitude = -10; 


Example 26. Graphic Drivers Routine 


[KR KKK KKK KK KK KK KK KK KK KR OR RK OK OK KK / 


/* FILE NAME: GRAPHIC2.C 
pe GRAPHICS DRIVER INITIALIZATION ROUTIN 
/* 


Eats 
o/ 
*/ 


GI 


[KR KKK KKK KKK KKK KK KR KK KR RK KK OK OK KK KK / 


#include 
#include 


<graphics.h> 
<stdlib.h> 
#include <stdio.h> 
#include <conio.h> 

void init_graphics (void) 


{ 


int i; 

int gdriver = DETECT, gmode, errorcode; int left, top, right, bottom; 
initgraph(&gdriver, &gmode, ""”); errorcode = graphresult(); 

if (errorcode != grOk); 


{ 


printf("Graphics error: %s\n", 


getch(); 


cleardevice(); 
setlinestyle(0,0,1); 
setcolor(1); 
setfillstyle(1,3); 


rectangle (1,1,getmaxx()-1,getmaxy()-1); 
setcolor(7); 

left = 5; 

top = getmaxy()/2 + - 123; 


right 108; 

bottom getmaxy()/2+ 163; 
rectangle (left,top, right, bottom) ; 
line(left,top + 30,right,top + 30); 

line (left,bottom+29, right, bottomt29) ; 
rectangle(left,top - 110,right+523,top - 5); 
rectangle (right+4,bottom + 5, 
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grapherrormsg (errorcode) ); 
printf(”Press any key to halt.\n”); 


1, 


right + 523,bottom + 70); 
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Example 26. Graphic Drivers Routine (Continued) 


rectangle (left,botom +5,right,bottomt+70) ; 
setcolor(15); 
settextstyle(0,0,1); 

/* outtextxy (left+25,top+12,”CONTROL”) ; 
outtextxy (right+16, bottom+32, "MESSAGES:”) ; 
outtextxy (left+13,bottom+13,”AIC STATUS”) ;*/ 
outtextxy (left+2,bottom+38,”Freq: 8kHz"”); 
outtextxy (left+2,bottomt+53,”Gain: 2”); 
settextstyle(0,0,3); 
outtextxy (left+10,top-72,”C54X EVM Spectrum Analyzer”); 
setlinestyle(0,0,3); 
setcolor(15); 


left = getmaxx() / 2 — 206; 
top = getmaxy() / 2 - 123; 
right = getmaxx() / 2 + 312; 
bottom = getmaxy() / 2 + 163; 


rectangle(left, top, right, bottom); 
floodfill (left+10,top+10,15); 
setcolor(15); 

setlinestyle(0,0,3); 


left = getmaxx()/2 - 311; 
top = getmaxy()/2 + 57 - 40; 
right = left + 25; 


bottom = top + 25; rectangle(left,top, right, bottom) ; 
setfillstyle(1,1); floodfill(left+5,top+5,15); 
settextstyle(0,0,1); 
outtextxy (left+5,topt10,”"F3”) ; 

// outtextxy (left+30,topt+10,”Quit”); 
setcolor(15); setlinestyle(0,0,3); 
left = getmaxx()/2 - 311; 
top = getmaxy()/2 - 23 - 40; 
right = left + 25; 
bottom = top + 25; rectangle(left,top, right, bottom) 
setfillstyle(1,1); floodfill(left+5,top+5,15); 
settextstyle(0,0,1); outtextxy (left+6,topt+10,”F1"”); 
outtextxy (left+30,top+9, ”"Decrease”) ; 
outtextxy (left+30,top+16, amplitude”) ; 
setcolor(15); 
setlinestyle(0,0,3); 


left = getmaxx()/2 - 311; 
top = getmaxy()/2 + 17 - 40; 
right = left + 25; 


bottom = top + 25; 

rectangle (left,top, right, bottom) ; 
setfillstyle(1,1); 

floodfill (left+5,topt+5,15); 

settextstyle(0,0,1); outtextxy (leftt+6,topt+10,”"F2”); 
outtextxy (left+30,top+9,” Increase”) ; 

outtextxy (left+30,top+16,”amplitude”) ; 
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Example 27. Display the Data on the Screen 


[KR KKK KKK KKK KKK KR KR KK OK KK KK KK OK KR KK OK KK KR KK / 


/* FILE NAME: VIEW2.C a 
/* DISPLAYS DATA ON THE SCREEN wf 
/* * / 


[KOR KKK KKK KKK KKK KK KK KK OK OK OK KK OK KK KK / 


#include "host.c” 
void screen (void) 
{ 
int x,y; 
int i,n; 
/* setup window (viewport) to display the AIC data */ 
x = getmaxx()/2 -— 203; 
y = getmaxy()/2; 
setviewport (x, y-120, x+512,y+160,1); 
/* move CP to left side of viewport */ 
x = getx(); 
y = gety() + 143; 
moveto (x,y); 
/* make waveform by drawing lines btwn 256 data points sent by EVM */ 
setlinestyle(0,0,1); 
setcolor(14); 
for (i=0;i<256;i++) lineto(x+1+2*i,y+tdataa[i]/amplitude) ; 
/* erase waveform just drawn by re-writing it in background color */ 
moveto (x,y); 
setcolor (3); 
for (i=0;i<256;i++) lineto(x+1+2*i,yt+tdataa[i]/amplitude) ; 
} 


Example 28. Linker Command File for the Application 


[KR KKK KKK KKK KK KK KR KKK KK KK OK KKK OK OK KK OK KR KK KK OK 


* This linker command file is assigns the memory allocation for the application 
* based on the EVM54x specifically 541. 
KOK KK KK OK KO KK KK KKK / 

vectors.obj 

init_54x.obj 

init_ser.obj 

init_aic.obj 

aic_cfg.obj 

memory .obj 

main.obj 

prces_int.obj 

rev_intl.obj 

task.obj 

£ir.ob7 

iir.obj 

sym_fir.obj 

adapt .obj 

echo.obj 

rfft.obj 

bit_rev.obj 

fft.obj 

unpack.obj 

power.obj 

hand_shk.obj 

hst_intl.obj 

fifo.obj 

-o main.out 

-m main.map 
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Example 28. Linker Command File for the Application (Continued) 


MEMORY 

{ 

PAGE 0: 
PROG : origin = 0x7000, length = 0x1000 
VECS : origin = Oxff80, length = Ox7f 
COFF_SYM: origin = 0x1400, length = 0x40 
COFF_FIR: origin = 0x1440, length = 0x40 
AIC_TBLE: origin = 0x1480, length = 0x10 
TASK_TBL: origin = 0x1490, length = 0x10 
TASK_INT: origin = 0x14a0, length = 0x10 
TIR_COFF: origin = 0x14b0, length = 0x10 
COEFFH : origin = 0x1500, length = 0x100 
TWID_SIN: origin = 0x1000, length = 0x80 
TWID_COS: origin = 0x1200, length = 0x80 
PAGE 1: /* Data space */ 
ALL_VARS: origin = 0x0080, length = 0x0080 
DRAM : origin = 0x0100, length = 0x1300 
EXT_DAT : origin = 0x1400, length = 0xE000 
REGS : origin = 0x0000, length = 0x0060 

} 

SECTIONS 

{ 

.text {} > PROG PAGE 0 /* code */ 
vectors {} > VECS PAGE 0 /* Vector table */ 
main_prg {} > PROG PAGE 0 
zeropad {} > PROG PAGE 0 
aic_cnfg {} > PROG PAGE 0 
ser_cnfg {} > PROG PAGE 0 
fifo fad {} > PROG PAGE 0 
task_hnd {} > PROG PAGE 0 
handshke {} > PROG PAGE 0 
fir_prog {} > PROG PAGE 0 
aa {} > PROG PAGE 0 
filter {} > PROG PAGE 0 
rfft_prg {} > PROG PAGE 0 
aic_reg {} > AIC_TBLE PAGE 0 
task_int {} > TASK_INT PAGE 0 
task_tbl {} > TASK_TBL PAGE 0 
coff_fir {} > COFF_FIR PAGE 0 
sym_fir {} > COFF_SYM PAGE 0 
ir coff {} > IIR_COFF PAGE 0 
coeffh {} > COEFFH PAGE 0 
sin_tbl {} > TWID_SIN PAGE 0 
cos_tbl {} > TWID_COS PAGE 0 
inpt_buf {} > DRAM, align(1024) PAGE 1 
outdata {} > DRAM,align(1024) PAGE 1 

UNION: > DRAM align(1024) PAGE 1 

{ 
£fe bfrtr 
adpt_sct: 

{ 
* (bufferw) /* This is needed for alignment of 128 words */ 
-+=80h; 
* (bufferp) 
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Example 28. Linker Command File for the Application (Continued) 


UNION: > DRAM align(256) PAGE 1 
{ 

fir bFr 

Cir bir 

Cofr- Wir 

bufferh 

twid_sin 
} 
UNION: > DRAM align(256) PAGE 1 
{ 

fir coft 

cir_bfrl 

bufferx 

twid_cos 
} 
GROUP: > ALL VARS PAG 
{ 


GI 
ray 


aic_vars 
rcv_vars 
fifo_var 
tsk_vars 
fir_vars 
iir_vars 


adpt_var 
fft_vars 
} 
stack : {} > DRAM PAGE 1 


} 


Example 29. Memory Map of TMS320C541 


7TMS320C541 MEMORY MAP 


M 

MA 0x0000, 1, Ox002A, RAM ; MMRs 

MA 0x0030, 1, 0x0003, RAM ; 

MA 0x0060, 1, O0x0020, RAM ; SCRATCH PAD 

MA 0x0080, 1, Ox1380, RAM ; INTERNAL DATA RAM 
MA 0x0080, O, Ox1380, RAM ; INTERNAL PROGRAM RAM 
MA 0x9000, 0, Ox7000, ROM ; INTERNAL ROM 

ma 0x1400, O, OxecO0O, ram ; external ram 

ma 0x1400, 1, OxecO0, ram ; external ram 

ma 0x0000, 2, 0x15, ioport ; i/o space 


map on 
7 
;Define reset alias to set PMST for MC mode 


7 


;alias myreset, "e pmst = Oxff80; reset ” 

7e pmst = OxffeO ; MP mode, OVLY, DROM off CLKOUT on 

7e hbpenbl = 0x0000 

e *0x28 = 0x2000 ; two wait states on i/o, none for memory 
e *0x29 = 0x0000 ; no bank switching necessary 

dasm pc 


echo Loaded TMS320C54x evminit.cmd 
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